domains

POST `/v1/domains/check`

Authority metrics for any domain, owned or not.

Tabbatar da Asali

Aiko da maɓallin API a matsayin bearer token. Wannan ma'anar ba ta bayyana takamaiman izini ba a cikin ƙayyadaddun bayanai, don haka ba wa maɓallin ku mafi ƙarancin abin da yake buƙata kuma ku bincika amsar maimakon yin zato.

Wannan wurin ƙarewa ba ya buƙatar ID na ƙungiya. Maɓallin ku ya riga ya gano ƙungiyar da yake ciki, kuma an iyakance amsa a kanta.

Gwada

May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.

curl -X POST https://api.zinndigital.com/v1/domains/check \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "fqdn": <string> }'

An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API

Bayani

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.

Jikin buƙata

Suna	Nau'i	Ana buƙata	Abin da yake
`fqdn`	`string`	Eh	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 showi…
`force`	`boolean`	A'a	Fetch even if a fresh cached reading exists. ⛔ Spends a billed unit — leave it false unless the customer explicitly asked for a new number.

Martani

Suna	Nau'i	Ana buƙata	Abin da yake
`fqdn`	`string`	Eh	—
`state`	`string<measured, not_in_index, never_fetched>`	Eh	`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` — n…
`measured_at`	`string`	A'a	When the stored reading was taken. Null when never fetched.
`is_stale`	`boolean`	Eh	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`	A'a	—
`spent_lookup`	`boolean`	Eh	False when the answer came from a recent stored reading and cost nothing.
`quota`	`SeoLookupQuota`	Eh	The research allowance meter, and what more costs.

Kuskuren da wannan matsaya za ta iya maido wa

401 · 403 · 422 · 429 · 503

POST /v1/domains/check