seo/
search-intent

Classifica fino a 1.000 parole chiave fornite in base all’intento di ricerca, con etichette primarie e secondarie e relative probabilità in record di parole chiave normalizzati.

Search Intent API

Input di parole chiave in batch
Quattro etichette di intento
Intento primario e secondario
0,1 crediti per parola chiave
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Search Intent

L’intento di ricerca descrive una query con etichette informative, di navigazione, commerciali o transazionali, insieme a segnali di probabilità primari e secondari. Queste classificazioni supportano l’etichettatura degli inventari di parole chiave, la revisione dell’intento misto, l’allineamento ai brief dei contenuti e l’instradamento di elenchi di parole chiave preparati verso flussi di lavoro di ricerca.

Funzionalità della Search Intent API

  • Classificazione in batch in base alla linguaClassifica fino a 1.000 parole chiave fornite in una lingua selezionata, usando l’inglese quando non viene indicata alcuna lingua.
  • Segnali di intento primario e secondarioRestituisce l’intento più probabile e la sua probabilità insieme ad altri intenti probabili e alle relative probabilità.
  • Record normalizzati e completiLeggi i campi normalizzati keyword e search_intent, mentre keyword_intent e secondary_keyword_intents restano conservati in extra.

Parametri della Search Intent API

ParametriObbligatorioDescrizione
keywordsObbligatorioElenco obbligatorio da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri.
location_codeFacoltativoCodice di località positivo facoltativo del mercato di ricerca.
location_nameFacoltativoNome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code.
language_codeFacoltativoCodice facoltativo della lingua di ricerca, da 2 a 10 caratteri. Il Playground usa per impostazione predefinita en.
languageFacoltativoNome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code.
results_limitFacoltativoTetto facoltativo dei risultati da 1 a 2.000.

Come usare la Search Intent API

Invia un elenco di parole chiave con impostazioni facoltative di mercato, lingua e limite dei risultati, poi leggi i record di intento normalizzati dall’attività asincrona completata.

  1. Prepara da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri.
  2. Invia con POST keywords ed eventuali campi facoltativi di mercato, lingua o results_limit a /v1/seo/search-intent e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
  4. Leggi data.results.items, poi segui next_cursor finché has_more resta true.
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

Casi d’uso della Search Intent API

  • Etichettatura dell’inventario di parole chiave: Usa ogni parola chiave e il suo intento primario per aggiungere etichette di intento coerenti a un inventario di parole chiave preparato.
  • Revisione dell’intento misto: Confronta le etichette primarie e secondarie con le relative probabilità per individuare le parole chiave che possono rappresentare più di un obiettivo di ricerca.
  • Instradamento nei flussi di lavoro di ricerca: Raggruppa le parole chiave fornite per intento informativo, di navigazione, commerciale o transazionale prima di instradarle in flussi di lavoro di ricerca separati.

Consigli degli esperti per la Search Intent API

  • Rimuovi le voci vuote e duplicate prima di inviare un batch, così la fatturazione basata sul numero di input rispecchia le parole chiave che vuoi classificare.
  • Mantieni coerenti i campi di mercato e lingua quando confronti i batch.
  • Esamina le probabilità dell’intento secondario quando una parola chiave ha un intento misto, invece di considerare l’etichetta primaria come un fatto universale.
  • Tieni presente che alcune classificazioni possono mancare e consulta extra quando verifichi gli oggetti originali keyword_intent e secondary_keyword_intents.

Oltre alla Search Intent API, usa queste API quando ti serve un altro tipo di dati pubblici di SEO.

  • Google Organic SERP API — Recupera una pagina di risultati Google in tempo reale per query e mercato con destinazioni, posizioni, tipi di elemento e dettagli completi dei risultati normalizzati.
  • Keyword Difficulty API — Confronta la difficoltà di posizionamento organico per un gruppo di parole chiave inviato, restituendo ogni parola chiave disponibile con il suo punteggio normalizzato.
  • Keyword Overview API — Arricchisce un gruppo di parole chiave inviato con domanda, concorrenza a pagamento, difficoltà, ricerche mensili e contesto dell’intento, se disponibili.
  • Keyword Search Volume API — Misura parole chiave note con volume di ricerca, CPC, concorrenza a pagamento e cronologia mensile delle ricerche, se disponibili.
  • Keyword Suggestions API — Espande una query di partenza in termini long-tail corrispondenti con misurazioni della domanda, cronologia mensile, contesto dell’intento e righe di origine complete, se disponibili.
  • Related Keywords API — Segue i percorsi delle ricerche correlate a partire da una query di partenza con controlli di profondità, misurazioni delle parole chiave, contesto dell’intento e righe di origine complete, se disponibili.

Esplora altre piattaforme

Combina i dati di SEO con i dati pubblici delle altre piattaforme social supportate.

Search Intent API — FAQ

Search Intent API è un’interfaccia programmatica per classificare fino a mille parole chiave fornite in una lingua selezionata. Restituisce, per ogni parola chiave disponibile, etichette di intento primarie e secondarie normalizzate con le relative probabilità.

Le quattro etichette sono informational, navigational, commercial e transactional.

Invia keywords, imposta facoltativamente location_code o location_name, scegli language_code o language e, se serve, usa results_limit da 1 a 2.000.

Invia da 1 a 1.000 parole chiave non vuote, con una lunghezza massima di 80 caratteri per parola chiave.

È la confidenza all’interno della classificazione dell’intento, non una probabilità di acquisto né un tasso di conversione. Le parole chiave a intento misto possono quindi includere classificazioni secondarie significative.

No. Alcune parole chiave inviate possono non produrre una classificazione, quindi abbina i record restituiti per parola chiave e gestisci le righe assenti.

Ogni parola chiave inviata costa 0,1 crediti SocQ.