hosting
POST /v1/sites/{siteId}/seo-metrics/check
Run an on-demand authority check for a hosted site.
Упълномощаване
Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/seo-metrics/check \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
Fetch this site's authority metrics now, against the customer's own metered daily allowance, and store the reading so it joins the site's history. ⭐ **A fresh stored reading is returned WITHOUT spending anything.** If the site was measured within the caching window the response comes back with `spent_lookup: false` and neither the daily allowance nor the provider is touched — which is what lets the Domains screen and the site panel share one purchase rather than buying the answer twice. ⛔ There is no `force`. The fleet sweep owns a hosted site's cadence; a flag that spent a unit however recently we measured would be a button whose whole purpose is to overpay. A customer who genuinely wants to re-ask uses `POST /v1/domains/check`. Requires the `majestic_metrics` entitlement, on the site's own plan or the org's. An account that is suspended or has no active subscription is refused before anything is spent (`403`), and its existing readings stay on screen.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
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` — n… |
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. |
Грешки, които този крайpoint може да върне
401 · 403 · 404 · 429 · 503