domains
POST /v1/domains/check
Authority metrics for any domain, owned or not.
प्रमाणीकरण
एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। यो इन्डपोइन्टले विशिष्ट अनुमति खुलाएको छैन, त्यसैले अनुमान गर्नुको सट्टा आफ्नो कुञ्जीलाई आवश्यक पर्ने न्यूनतम अधिकार दिनुहोस् र प्रतिक्रिया जाँच गर्नुहोस्।
यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।
प्रयास गर्नुहोस्
कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।
curl -X POST https://api.zinndigital.com/v1/domains/check \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "fqdn": <string> }'लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्
विवरणहरू
Majestic Trust Flow, Citation Flow, referring domains and topical trust for a domain you are considering — it does not have to be one of yours. Gated on sites.view plus two entitlements, both asserted before the provider is called: every check spends a billed index-item unit against Zinn®'s shared subscription, so an organisation that cannot see the answer never costs one. ⛔ The two keys answer different questions and neither implies the other. domain_checker says the plan includes this product — a checker for a domain you do not own. majestic_metrics says the plan includes the authority data, and it also gates the SEO tab on domains you already own. A plan may sell figures on your own domains without selling a pre-purchase checker, so one key could not express both. ⭐ A cached reading inside its TTL is returned without spending anything — re-checking a domain from an hour ago is the commonest thing an operator does while comparing a shortlist. Pass force when you genuinely want a fresh number. ⛔ A malformed hostname is refused locally, with a 422. A pasted URL is normalised rather than rejected (that is what is actually in the clipboard), but an email address or a sentence never reaches the provider — every one that did would be a billed unit answering a question nobody asked. ⛔ null and 0 mean opposite things in the response: null is the provider did not tell us, 0 is the provider said zero. A brand-new domain genuinely has Trust Flow 0 and so does one nobody has ever crawled, and on a PBN that difference decides a purchase. Metered per day. Each check that reaches the provider spends one of the account's daily allowance, and the response carries the meter as it stands afterwards, plus spent_lookup saying whether this particular answer cost anything. A cached reading is free. Nothing is charged when the request fails — a provider outage, an unconfigured provider or a malformed domain all leave the allowance untouched. 429 means the daily allowance is used up: buy more with POST /v1/seo/quota/top-up, or wait for the reset at midnight UTC. That is distinct from 403, which means this account may not use the checker at all — the plan does not include it, or the account is suspended or unpaid.
अनुरोध बडी
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
fqdn | string | हुन्छ | The domain to check. A pasted URL is accepted and normalised down to the hostname; www. is stripped, because it and the apex are one domain to every metrics provider and showing… |
force | boolean | हैन | Fetch even if a fresh cached reading exists. ⛔ Spends a billed unit — leave it false unless the customer explicitly asked for a new number. |
प्रतिक्रिया
| नाम | प्रकार | आवश्यक | यो के हो |
|---|---|---|---|
fqdn | string | हुन्छ | — |
state | string<measured, not_in_index, never_fetched> | हुन्छ | measured — the provider returned figures (which may be zero, a real measurement). not_in_index — the provider answered and has never crawled this domain. never_fetched — no… |
measured_at | string | हैन | When the stored reading was taken. Null when never fetched. |
is_stale | boolean | हुन्छ | True when the reading is older than the 24h refresh window, or absent entirely. A hint that a refresh is worth its allowance — not an indication the figures are wrong. |
metrics | SeoAuthorityMetrics | हैन | — |
spent_lookup | boolean | हुन्छ | False when the answer came from a recent stored reading and cost nothing. |
quota | SeoLookupQuota | हुन्छ | The research allowance meter, and what more costs. |
यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू
401 · 403 · 422 · 429 · 503