Search Intent
Search Intent beschreibt eine Suchanfrage über die Labels informational, navigational, commercial oder transactional, zusammen mit Wahrscheinlichkeitssignalen für die primäre und die sekundäre Intention. Diese Klassifizierungen eignen sich für die Kennzeichnung von Keyword-Inventaren, die Prüfung gemischter Intentionen, die Abstimmung mit Content-Briefings und das Weiterleiten vorbereiteter Keyword-Listen in Recherche-Workflows.
Funktionen der Search Intent API
- Sprachabhängige Batch-KlassifizierungKlassifiziert bis zu 1.000 übermittelte Keywords in einer gewählten Sprache; ist keine Sprache angegeben, wird Englisch verwendet.
- Signale zur primären und sekundären IntentionLiefert die wahrscheinlichste Intention samt Wahrscheinlichkeit zusammen mit weiteren wahrscheinlichen Intentionen und deren Wahrscheinlichkeiten.
- Normalisierte und vollständige DatensätzeLesen Sie die normalisierten Felder keyword und search_intent, während keyword_intent und secondary_keyword_intents in extra erhalten bleiben.
Parameter der Search Intent API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
keywords | Erforderlich | Erforderliche Liste mit 1 bis 1.000 nicht leeren Keywords, die jeweils höchstens 80 Zeichen lang sind. |
location_code | Optional | Optionaler positiver Code des Suchmarkts. |
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 verwendet 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 | Optionale Ergebnisobergrenze von 1 bis 2.000. |
So verwenden Sie die Search Intent API
Senden Sie eine Keyword-Liste mit optionalen Einstellungen für Markt, Sprache und Ergebnisgrenze und lesen Sie anschließend die normalisierten Intentionsdatensätze aus der abgeschlossenen asynchronen Aufgabe.
- Bereiten Sie 1 bis 1.000 nicht leere Keywords vor, die jeweils höchstens 80 Zeichen lang sind.
- Senden Sie keywords und alle optionalen Felder für Markt, Sprache oder results_limit per POST an /v1/seo/search-intent 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/search-intent" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["how to research keywords","buy seo software"],"language_code":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Search Intent API
- Kennzeichnung eines Keyword-Inventars: Nutzen Sie jedes Keyword mit seiner primären Intention, um einem vorbereiteten Keyword-Inventar einheitliche Intentions-Labels hinzuzufügen.
- Prüfung gemischter Intentionen: Vergleichen Sie primäre und sekundäre Labels mit ihren Wahrscheinlichkeiten, um Keywords zu erkennen, die mehr als ein Suchziel abbilden können.
- Weiterleitung in Recherche-Workflows: Gruppieren Sie übermittelte Keywords nach informational, navigational, commercial oder transactional, bevor Sie sie in getrennte Recherche-Workflows weiterleiten.
Profi-Tipps zur Search Intent API
- Entfernen Sie leere und doppelte Einträge, bevor Sie einen Batch senden, damit die eingabebasierte Abrechnung den Keywords entspricht, die Sie klassifizieren möchten.
- Halten Sie die Felder für Markt und Sprache konsistent, wenn Sie Batches vergleichen.
- Prüfen Sie die Wahrscheinlichkeiten der sekundären Intention, wenn ein Keyword gemischte Intention hat, statt das primäre Label als allgemeingültige Tatsache zu behandeln.
- Rechnen Sie mit fehlenden Klassifizierungen, und lesen Sie extra, wenn Sie die ursprünglichen Objekte keyword_intent und secondary_keyword_intents prüfen.
Verwandte APIs
Ergänzend zur Search Intent 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.
- Keyword Suggestions API — Eine Ausgangsanfrage zu passenden Long-Tail-Begriffen erweitern – mit verfügbaren Nachfragewerten, monatlichem Verlauf, Kontext zur Suchintention und vollständigen Quellzeilen.
- Related Keywords API — Verwandten Suchpfaden ab einer Ausgangsanfrage folgen – mit Steuerung der Tiefe, verfügbaren Keyword-Messwerten, Kontext zur Suchintention und vollständigen Quellzeilen.
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages 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