domains

GET /v1/domains/{domainId}/seo-metrics

Get a domain's SEO authority metrics.

Wszystkie punkty końcowe domains

Wszystkie dokumentacje dla programistów

Uwierzytelnianie

Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X GET https://api.zinndigital.com/v1/domains/{domainId}/seo-metrics \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

The cached authority reading for this domain — Trust Flow, Citation Flow, referring domains and backlinks. Included on every Footprint-Free plan. This never calls the upstream provider, so it is free to render and poll. Use the refresh endpoint to fetch a new reading; each refresh consumes provider allowance. state distinguishes three cases that must not be conflated: measured (numbers, which may legitimately be zero), not_in_index (the provider answered and has never seen this domain), and never_fetched (nothing has been requested yet). Individual metrics are nullable — null means the provider did not supply that figure, 0 means it measured zero.

Parametry

NazwaTypWymaganeCo to jest
domainId (path)UuidTakThe domain's id.

Odpowiedź

NazwaTypWymaganeCo to jest
fqdnstringTak
statestring<measured, not_in_index, never_fetched>Takmeasured — 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_atstringNieWhen the stored reading was taken. Null when never fetched.
is_stalebooleanTakTrue 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.
metricsSeoAuthorityMetricsNie

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 429