Domain Overview
Die Suchpräsenz einer Domain ist ihre Sichtbarkeit in den Google-Ergebnissen für ein Land und eine Sprache, zusammengefasst als Zahl der Keywords, für die sie rankt, als geschätzte monatliche Besuche aus diesen Rankings und als Betrag, den dieser Traffic in Anzeigen kosten würde, aufgeteilt in organisch und bezahlt und verteilt auf Positionsbereiche von 1 bis 100, dazu die Zahl neuer, gestiegener, gefallener und verlorener Rankings. Eine Zeile mit diesen Summen zeigt die Größe eines Wettbewerbers, qualifiziert Interessenten nach ihrer Suchpräsenz und verfolgt, Monat für Monat gespeichert, wie sich die Sichtbarkeit der eigenen Website entwickelt.
Funktionen der Domain Overview API
- Eine Domain in einem Google-Markttarget nimmt eine Domain an, und die Orts- und Sprachparameter wählen Land und Sprache der Suchergebnisse, standardmäßig United States und Englisch; die Zeile wiederholt location_code und language_code, damit gespeicherte Schnappschüsse beschriftet bleiben.
- Organisch und bezahlt im selben Aufbauorganic und paid enthalten jeweils dieselben Summen, sodass sich unbezahlte Rankings und Suchanzeigen Feld für Feld vergleichen lassen.
- Traffic mit seinem Anzeigenwertkeywords_count zählt die rankenden Keywords, estimated_traffic gibt die monatlichen Besuche daraus an, und estimated_traffic_cost bewertet diesen Traffic in US-Dollar zu Google-Ads-Preisen.
- Zwölf Positionsbereichepositions teilt die rankenden Keywords in pos_1, pos_2_3, pos_4_10 und weitere Bereiche bis pos_91_100 auf und zeigt, ob eine Domain auf Seite eins gewinnt oder weiter hinten in den Ergebnissen steht.
- Ranking-Bewegungen seit dem letzten Updatenew_count, up_count, down_count und lost_count geben an, wie viele Keywords seit der vorherigen Datenaktualisierung neu ins Ranking kamen, gestiegen, gefallen oder herausgefallen sind.
Parameter der Domain Overview API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
target | Erforderlich | Zu analysierende Domain oder Subdomain, etwa notion.so; https:// und www. werden entfernt, eine URL mit Pfad wird abgelehnt. |
location_code | Optional | Numerischer Code des Suchlands, etwa 2840 für die USA, der Standardwert. Verwenden Sie diesen oder location_name. |
location_name | Optional | Ländername wie United States als Alternative zu location_code; werden beide gesendet, müssen sie dasselbe Land bezeichnen. |
language_code | Optional | Sprachcode wie en, der Standardwert; er muss zu den im gewählten Land verfügbaren Sprachen gehören. |
language | Optional | Sprachname wie English als Alternative zu language_code; werden beide gesendet, müssen sie übereinstimmen. |
So verwenden Sie die Domain Overview API
Senden Sie eine Domain mit ihrem Markt und lesen Sie die Übersichtszeile, sobald die Aufgabe abgeschlossen ist.
- Senden Sie {"target": "notion.so", "location_code": 2840, "language_code": "en"} per POST an /v1/seo/domain-overview.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die einzelne Übersichtszeile aus results.items; results.next_cursor ist nur relevant, wenn has_more true ist.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","location_code":2840,"language_code":"en"}'
# One market per request, 5 credits.Anwendungsfälle der Domain Overview API
- Die Suchpräsenz eines Wettbewerbers einschätzen: Lesen Sie organic.keywords_count und organic.estimated_traffic, um zu sehen, wie viel eines Markts ein Konkurrent bereits über Google erreicht.
- Die eigene Sichtbarkeit Monat für Monat verfolgen: Speichern Sie jeden Monat die Bereiche in positions sowie die Zahlen für neue, gestiegene, gefallene und verlorene Keywords, um darzustellen, ob die Rankings Richtung Seite eins klettern.
- Interessenten für Agenturen qualifizieren: Nutzen Sie organic.estimated_traffic_cost als Dollarbetrag für den Wert des Suchtraffics eines Interessenten, wenn Sie entscheiden, welche Kunden Sie ansprechen.
- Prüfen, ob eine Website Suchanzeigen schaltet: paid.keywords_count und paid.estimated_traffic zeigen, ob eine Domain im Markt Google-Suchanzeigen schaltet und wie viel Traffic sie bringen.
- Eine Website über Länder hinweg vergleichen: Übergeben Sie dieselbe Domain mit verschiedenen Orts- und Spracheinstellungen, um zu sehen, in welchen Märkten sie am stärksten ist.
Profi-Tipps zur Domain Overview API
- Für ein Land ohne Englisch setzen Sie language_code oder language selbst, denn der Standardwert en wird nur akzeptiert, wo das Land Englisch anbietet.
- Addieren Sie pos_1, pos_2_3 und pos_4_10, um die Zahl der Keywords auf der ersten Seite zu erhalten, da die Bereiche getrennte, sich nicht überschneidende Spannen sind.
- Lesen Sie die Zahlen für neue, gestiegene, gefallene und verlorene Keywords als Änderungen seit der vorherigen Datenaktualisierung, nicht seit Ihrer letzten Anfrage, und speichern Sie jede Zeile mit collected_at, um einen eigenen Verlauf aufzubauen.
- Senden Sie die reine Domain; für Kennzahlen einzelner Seiten der Website nutzen Sie die Relevant Pages API, die Ranking-Verteilungen Seite für Seite liefert.
Verwandte APIs
Ergänzend zur Domain Overview API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher SEO-Daten benötigen.
- Google Organic SERP API — Eine aktuelle Google-Ergebnisseite per Suchanfrage und Markt abrufen – mit normalisierten Zielen, Rängen, Elementtypen und vollständigen Ergebnisdetails.
- Keyword Difficulty API — Die Ranking-Schwierigkeit in der organischen Suche für eine übermittelte Keyword-Liste vergleichen und jedes verfügbare Keyword mit seinem normalisierten Wert zurückgeben.
- Keyword Overview API — Eine übermittelte Keyword-Liste um verfügbaren Kontext zu Nachfrage, bezahltem Wettbewerb, Schwierigkeit, monatlichen Suchen und Suchintention anreichern.
- Ranked Keywords API — Keywords finden, für die eine Domain, Subdomain oder Seite rankt – mit passenden URLs, Positionen, Suchwerten, Suchintention und vollständigen Quellelementen.
- Competitor Domains API — Die Domains finden, die in einem Markt für dieselben Google-Keywords ranken wie eine Website – mit Zahl gemeinsamer Keywords, durchschnittlicher Position, Traffic der Überschneidung und vollen Suchkennzahlen.
- Traffic Estimate API — Monatliche organische und bezahlte Google-Suchbesuche sowie Keyword-Zahlen für bis zu 1.000 Domains in einem Markt schätzen.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API