Keywords for Site
Keywords-for-Site-Datensätze verbinden das Thema einer Website mit relevanten Suchbegriffen, Suchvolumen, CPC, bezahltem Wettbewerb, monatlicher Nachfrage und Kategoriekontext. Diese Beziehungen zwischen Keywords und Kennzahlen eignen sich für die Themenfindung, die Konkurrenzrecherche, den Aufbau von Kandidatenlisten und den domainübergreifenden Vergleich.
Funktionen der Keywords for Site API
- Relevanzbasierte Entdeckung über die DomainNutzen Sie eine Website-Domain, um Keyword-Ideen zu ihrem Thema abzurufen, statt von einer Seed-Phrase auszugehen.
- Kennzahlen zu Nachfrage und bezahlter SucheBewerten Sie jedes zurückgegebene Keyword anhand des normalisierten Suchvolumens, des CPC, des bezahlten Wettbewerbs, der Wettbewerbsstufe und der monatlichen Suchbeobachtungen.
- Vollständiger Keyword-KontextPrüfen Sie extra auf die vollständige zurückgegebene Zeile, in der optionale Kategorien, Schwierigkeit, Suchintention, Trendfelder und weitere nicht übernommene Attribute zugänglich bleiben.
Parameter der Keywords for Site API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
target | Erforderlich | Erforderliche Website-Domain als Themenquelle. Der Playground verwendet standardmäßig microsoft.com. |
location_code | Optional | Optionaler positiver Code des Suchmarkts. Der Playground sendet standardmäßig 2840. |
location_name | Optional | Optionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code. |
language_code | Optional | Optionaler Sprachcode der Suche mit 2 bis 10 Zeichen. Der Playground sendet standardmäßig en. |
language | Optional | Optionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code. |
results_limit | Optional | Gewünschte Obergrenze für Quellergebnisse von 1 bis 1.000. Der Playground sendet 5, passend zum Beispiel in der Dokumentation; das Backend verwendet 100, wenn der Wert fehlt. |
So verwenden Sie die Keywords for Site API
Senden Sie eine Domain mit Einstellungen für Markt, Sprache und Ergebnisgrenze und lesen Sie anschließend die normalisierten Keyword-Datensätze aus der abgeschlossenen Aufgabe.
- Wählen Sie ein Domain-Ziel target, einen positiven location_code, einen language_code und ein results_limit von 1 bis 1.000.
- Senden Sie die Nutzdaten per POST an /v1/seo/keywords-for-site und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
- Lesen Sie data.results.items und folgen Sie dann next_cursor, solange has_more den Wert true behält.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Keywords for Site API
- Themenfindung für Websites: Nutzen Sie zurückgegebene Keywords und Kategorien, um Suchthemen zu erkennen, die mit einer bekannten Website verbunden sind.
- Keyword-Recherche zur Konkurrenz: Senden Sie die Domain eines Wettbewerbers und kombinieren Sie relevante Begriffe mit Suchvolumen, CPC und bezahltem Wettbewerb zu einer Recherchemenge.
- Themenvergleich über Domains hinweg: Führen Sie Website-Ziele getrennt aus und vergleichen Sie ihre zurückgegebenen Keyword-Mengen, Kategorien und Nachfragekennzahlen.
Profi-Tipps zur Keywords for Site API
- Entfernen Sie http:// und https:// aus target, bevor Sie die Domain senden, um ein ungültiges Zielformat zu vermeiden.
- Legen Sie Markt und Sprache beim Vergleich von Abfragen ausdrücklich fest, statt sich bei fehlenden Feldern auf das Verhalten des Anbieters zu verlassen.
- Wählen Sie results_limit als größte sinnvolle einzelne Ergebnismenge, weil dieser Endpunkt keinen Offset kennt, mit dem sich ein späteres Ergebnisfenster anfordern ließe.
- Behandeln Sie fehlende Kennzahlen als nicht verfügbar und nicht als null, und prüfen Sie extra, wenn ein benötigtes Attribut nicht in den normalisierten Feldern steht.
- Verwenden Sie stattdessen Ranked Keywords, wenn Sie beobachtete Positionen oder Ranking-URLs statt relevanzbasierter Keyword-Ideen benötigen.
Verwandte APIs
Ergänzend zur Keywords for Site 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.
- Keyword Search Volume API — Bekannte Keywords mit verfügbarem Suchvolumen, CPC, bezahltem Wettbewerb und monatlichem Suchverlauf messen.
- Ranked Keywords API — Keywords finden, für die eine Domain, Subdomain oder Seite rankt – mit passenden URLs, Positionen, Suchwerten, Suchintention und vollständigen Quellelementen.
- Relevant Pages API — Indexierte Seiten einer Domain erfassen – mit Verteilungen organischer und bezahlter Rankings, modelliertem Traffic und geschätztem Kostenkontext.
- Keyword Suggestions API
- Related Keywords API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API