domains
POST /v1/domains/{domainId}/seo-metrics/refresh
Fetch a fresh SEO authority reading for a domain.
Autenticação
Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.
Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.
Experimente
Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.
curl -X POST https://api.zinndigital.com/v1/domains/{domainId}/seo-metrics/refresh \
-H "Authorization: Bearer zdk_live_…"Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API
Detalhes
Calls the upstream provider and stores a new snapshot, then returns it in the same shape as the GET. **Consumes provider allowance on every call**, so it is driven by an explicit user action or a scheduled sweep — never by rendering a page. Returns 503 when the provider is unreachable, unconfigured, or the allowance is exhausted; in every one of those cases the previously stored reading is left untouched and still served by the GET.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
domainId (path) | Uuid | Sim | The domain's id. |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
fqdn | string | Sim | — |
state | string<measured, not_in_index, never_fetched> | Sim | `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 | Não | When the stored reading was taken. Null when never fetched. |
is_stale | boolean | Sim | 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 | Não | — |
Erros que este endpoint pode retornar
401 · 403 · 404 · 429 · 503