v1Ressourcen/Veröffentlichte Einträge/getCitation Index abrufen
Citation Index abrufen
Wie viele Verzeichnisse diesen Standort indizieren, aktuell im Vergleich zu einem vorherigen Zeitraum.
get
seo:read/api/v1/seo/citation-indexQuery-Parameter
locationIdstringerforderlich
Der abzufragende Standort. Nachschlagen mit GET /api/v1/locations.
clientIdstringoptional
Der Kunde des Standorts. Nur zur Eindeutigkeit nötig, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist.
fromstringoptional
Fensterbeginn (ISO-Datum). Standard: vor 30 Tagen.
tostringoptional
Fensterende (ISO-Datum). Standard: jetzt.
Antwort
dataobjectoptional
availablebooleanoptional
Ob für diesen Standort bereits ein Citation-Index-Snapshot existiert.
currentobjectoptional
Der letzte Snapshot am oder vor dem Fensterende.
percentagenumberoptional
Prozentsatz der aktuell indexierten Einträge (0–100), oder null.
listingsnumberoptional
Gesamtzahl der in diesem Snapshot gezählten aktiven Einträge, oder null.
indexednumberoptional
Davon die Anzahl der indexierten Einträge, oder null.
weekStartstringoptional
Die Woche des Snapshots, als Montag 00:00 UTC.
recordedAtstringoptional
Wann dieser Snapshot zuletzt geschrieben wurde.
previousobjectoptional
Der letzte Snapshot am oder vor dem Fensterbeginn, zum Vergleich.
percentagenumberoptional
Prozentsatz der aktuell indexierten Einträge (0–100), oder null.
listingsnumberoptional
Gesamtzahl der in diesem Snapshot gezählten aktiven Einträge, oder null.
indexednumberoptional
Davon die Anzahl der indexierten Einträge, oder null.
weekStartstringoptional
Die Woche des Snapshots, als Montag 00:00 UTC.
recordedAtstringoptional
Wann dieser Snapshot zuletzt geschrieben wurde.
inventoryobjectoptional
Die heutigen Live-Eintragsseiten dieses Standorts, jeweils mit dem zuletzt erfassten Ergebnis. Nicht vergleichbar mit den wöchentlichen Snapshots in current und previous.
basisstring (current_inventory)erforderlich
Immer current_inventory: Dies sind die heutigen Seiten, kein früherer Snapshot.
pagesarray of objecterforderlich
Ein Eintrag pro Live-Eintragsseite.
idstringerforderlich
Die ID des Eintrags.
publisherIdstringerforderlich
Die ID des Publishers.
namestringerforderlich
Der Name des Publishers.
urlstringerforderlich
Die URL der Live-Eintragsseite. Null, wenn der gespeicherte Link keine absolute http(s)-URL ist.
statusstring (indexed | not_indexed | pending | not_checked)erforderlich
Das zuletzt erfasste Ergebnis, keine Live-Prüfung: indexed, not_indexed, pending oder not_checked. pending und not_checked sind unbekannt, niemals ein negatives Ergebnis.
checkedAtstringerforderlich
Wann die letzte Prüfung erfasst wurde, oder null.
indexedAtstringerforderlich
Wann die Seite als indexiert bestätigt wurde, oder null. Eine als indexiert bestätigte Seite wird nicht erneut geprüft.
countsobjecterforderlich
Die Seiten, nach Status gezählt.
totalintegererforderlich
Live-Eintragsseiten.
indexedintegererforderlich
Seiten, die in der Google-Suche erscheinen.
notIndexedintegererforderlich
Seiten mit dem erfassten Ergebnis „nicht indexiert“.
pendingintegererforderlich
Seiten, die auf ein Ergebnis warten. Unbekannt, niemals ein negatives Ergebnis.
notCheckedintegererforderlich
Seiten, für die noch kein verwertbares Ergebnis vorliegt. Unbekannt, niemals ein negatives Ergebnis.
latestEvidenceAtstringerforderlich
Wann die neueste Prüfung oder Bestätigung über alle Seiten erfasst wurde, oder null. Kann ein Bestätigungsdatum ohne neue Prüfung sein.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/seo/citation-index
Ihr API-Schlüssel
locationId *
clientId
from
to
{
"data": {
"available": true,
"current": {
"percentage": 90.48,
"listings": 42,
"indexed": 38
},
"previous": {
"percentage": 83.33,
"listings": 42,
"indexed": 35
}
}
}