seo/
search-intent

Bis zu 1.000 übermittelte Keywords nach Suchintention klassifizieren – mit primären und sekundären Labels samt Wahrscheinlichkeiten in normalisierten Keyword-Datensätzen.

Search Intent API

Batch-Eingabe von Keywords
Vier Intentions-Labels
Primäre und sekundäre Intention
0,1 Credits pro Keyword
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
keywordsErforderlichErforderliche Liste mit 1 bis 1.000 nicht leeren Keywords, die jeweils höchstens 80 Zeichen lang sind.
location_codeOptionalOptionaler positiver Code des Suchmarkts.
location_nameOptionalOptionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code.
language_codeOptionalOptionaler Sprachcode der Suche mit 2 bis 10 Zeichen. Der Playground verwendet standardmäßig en.
languageOptionalOptionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code.
results_limitOptionalOptionale 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.

  1. Bereiten Sie 1 bis 1.000 nicht leere Keywords vor, die jeweils höchstens 80 Zeichen lang sind.
  2. 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.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie SEO-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Search Intent API — FAQ

Search Intent API ist eine Schnittstelle, die bis zu 1000 übermittelte Keywords in einer gewählten Sprache klassifiziert. Sie liefert für jedes verfügbare Keyword normalisierte primäre und sekundäre Intentions-Labels mit Wahrscheinlichkeiten.

Die vier Labels sind informational, navigational, commercial und transactional.

Senden Sie keywords, legen Sie optional location_code oder location_name fest, wählen Sie language_code oder language und verwenden Sie bei Bedarf results_limit von 1 bis 2.000.

Senden Sie 1 bis 1.000 nicht leere Keywords mit einer maximalen Länge von 80 Zeichen pro Keyword.

Sie ist die Konfidenz innerhalb der Intentionsklassifizierung und weder eine Kaufwahrscheinlichkeit noch eine Conversion-Rate. Keywords mit gemischter Intention können daher aussagekräftige sekundäre Klassifizierungen enthalten.

Nein. Zu manchen übermittelten Keywords kann eine Klassifizierung ausbleiben; ordnen Sie zurückgegebene Datensätze daher über das Keyword zu und behandeln Sie fehlende Zeilen.

Jedes übermittelte Keyword kostet 0,1 SocQ-Credits.