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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
keywords | Obbligatorio | Elenco obbligatorio da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri. |
location_code | Facoltativo | Codice di località positivo facoltativo del mercato di ricerca. |
location_name | Facoltativo | Nome facoltativo del mercato di ricerca, alternativo a location_code. Se compilato, ha la precedenza su location_code. |
language_code | Facoltativo | Codice facoltativo della lingua di ricerca, da 2 a 10 caratteri. Il Playground usa per impostazione predefinita en. |
language | Facoltativo | Nome facoltativo della lingua di ricerca, alternativo a language_code. Se compilato, ha la precedenza su language_code. |
results_limit | Facoltativo | Tetto 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.
- Prepara da 1 a 1.000 parole chiave non vuote, ciascuna di non più di 80 caratteri.
- 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.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.
- 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