Torna alle API
Intelligence su SERP e parole chiave

API SEO per risultati di ricerca, parole chiave e posizionamenti

Interroga in tempo reale i risultati organici di Google, confronta domanda delle parole chiave e difficoltà di posizionamento, espandi i termini di partenza, scopri le parole chiave e le pagine che determinano la visibilità di un sito nelle ricerche, classifica l’intento di ricerca e raccogli i risultati di Google News, Google Images, Google Autocomplete, Bing e YouTube. Ogni endpoint usa la stessa chiave API di SocQ, lo stesso flusso di attività asincrono e lo stesso formato di risultati normalizzato.

API SEO disponibili

Scegli in base all’input e all’obiettivo della ricerca: usa Google Organic SERP per una singola query; Keyword Difficulty, Keyword Overview, Keyword Search Volume o Search Intent per elenchi già pronti; Keyword Suggestions o Related Keywords per i termini di partenza; Keywords for Site, Ranked Keywords o Relevant Pages per la ricerca su domini e pagine; e Google News, Google Images, Google Autocomplete, Bing Search o YouTube Rank Tracker per le altre superfici di ricerca. Per monitorare le risposte AI, usa le API AI Search.

Quali dati SEO puoi recuperare?

Usa campi normalizzati di primo livello per le analisi più comuni, con gli oggetti completi della fonte conservati quando un endpoint restituisce contesto aggiuntivo.

Risultati organici di Google

Recupera titoli, URL di destinazione, posizioni in classifica, tipi di elemento dei risultati e dettagli disponibili dei risultati per una query e un mercato di ricerca.

Domanda di ricerca e metriche a pagamento

Misura volume di ricerca, CPC, concorrenza a pagamento e cronologia mensile delle ricerche, quando disponibili, per parole chiave già pronte o scoperte.

Difficoltà del posizionamento organico

Confronta i punteggi di difficoltà delle parole chiave da 0 a 100, quando disponibili, su elenchi fino a 1.000 termini in un mercato selezionato.

Scoperta di parole chiave

Espandi una query o un sito web di partenza in termini suggeriti e correlati con metriche di domanda, cronologia mensile e profondità della relazione, quando disponibili.

Visibilità di siti e pagine

Trova parole chiave che si posizionano, URL, posizioni, contesto del traffico stimato, pagine indicizzate e distribuzioni dei posizionamenti per un dominio, un sottodominio o una pagina.

Intento di ricerca

Classifica le parole chiave fornite con etichette di intento primario e secondario e punteggi di probabilità, quando disponibili.

Superfici di ricerca oltre il web di Google

Raccogli per una query e un mercato gli articoli di Google News con testata e link diretto, i risultati di Google Immagini con pagina di origine, i suggerimenti di Google Autocomplete, le posizioni organiche di Bing e le classifiche dei video di YouTube.

API SEO di SocQ vs DataForSEO

SocQ è la scelta più semplice quando il tuo prodotto ha bisogno dell’intelligence di base sulla ricerca di Google e dei dati pubblici dei social media dietro un’unica chiave API, un unico ciclo di vita delle attività e un unico modello di risultati normalizzato. DataForSEO offre un catalogo SEO specializzato più ampio, con metodi e controlli più specifici per prodotto.

FunzionalitàSocQDataForSEO
Ideale perFlussi di lavoro di base su SERP di Google, parole chiave, posizionamenti, pagine e intento, insieme alle API di dati pubblici dei social mediaInfrastruttura dedicata a SEO e SEM, con dati più ampi su motori di ricerca, backlink, on-page, aziende, merchant e app
AutenticazioneUn’unica chiave API Bearer per gli endpoint SEO e per gli endpoint supportati di dati dei social mediaBasic Authentication con un login API e una password generata
Modello di richiestaPayload diretti come oggetti JSON e un unico flusso asincrono di invio, interrogazione e risultati archiviatiMetodi Live o Standard specifici per prodotto con array di oggetti attività
Modello dei risultatiCampi normalizzati di primo livello più il contesto completo della fonteAttività e risultati nativi annidati, con la forma definita da ogni prodotto API
Visibilità dei costiRegole sui crediti su ogni scheda degli endpoint, stime prima dell’invio e utilizzo finale nella dashboardPrezzi a consumo che variano in base ad API, metodo, priorità, profondità dei risultati e parametri facoltativi

Come funziona l’API SEO

Ogni endpoint segue lo stesso ciclo di vita asincrono e accetta la forma di input richiesta dal proprio flusso di ricerca.

  1. 1. Scegli la forma dell’input

    Invia una query, un elenco di parole chiave già pronto, un termine di partenza o un dominio o una pagina di destinazione, poi imposta i campi di mercato e lingua supportati.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione non riesce o non fallisce, con un backoff dopo le risposte di pressione temporanea.

  3. 3. Leggi i risultati normalizzati

    Leggi data.results.items e segui next_cursor finché has_more è true.

Arricchisci un elenco di parole chiave con una sola richiesta

Keyword Overview è un buon punto di partenza quando hai già dei termini da valutare. Apri la scheda di un endpoint per il payload esatto usato da un altro flusso di lavoro.

curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      "keyword research",
      "seo tools"
    ],
    "location_code": 2840,
    "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 comuni dell’API SEO

Ricerca e monitoraggio delle SERP

Acquisisci i risultati organici, gli URL di destinazione, i tipi di elemento e le posizioni in classifica restituiti per una query in un mercato selezionato.

Definizione delle priorità delle parole chiave

Confronta domanda, CPC, concorrenza a pagamento, difficoltà organica e cronologia mensile su un portafoglio di parole chiave esistente.

Long tail e pianificazione dei contenuti

Espandi i termini di partenza in suggerimenti e query correlate per brief dei contenuti, cluster di argomenti e pianificazione delle campagne.

Ricerca sulla visibilità dei concorrenti

Trova parole chiave, URL che si posizionano, posizioni e contesto del traffico stimato associati al dominio o alla pagina pubblica di un concorrente.

Analisi delle opportunità per le pagine

Cataloga le pagine indicizzate rilevanti e le distribuzioni dei posizionamenti per individuare pagine e argomenti da approfondire.

Instradamento e reportistica per intento

Usa le etichette di intento primario e secondario per segmentare i termini per contenuti, ricerca a pagamento, pagine di prodotto o pipeline di reportistica.

Monitoraggio della ricerca di notizie, immagini e video

Tieni d’occhio, per le parole chiave che contano per il tuo brand, la copertura su Google News, le foto prodotto su Google Immagini e le classifiche dei video su YouTube.

Limiti e interpretazione

I risultati dipendono dall’endpoint selezionato, dal mercato di ricerca, dalla lingua, dalla disponibilità delle fonti e dall’ambito della query, delle parole chiave, del dominio o della pagina inviati.

  • Ogni endpoint ha una propria specifica del payload: alcuni accettano array di parole chiave, altri una sola query, un termine di partenza, un dominio, un sottodominio o l’URL di una pagina.
  • Località, lingua, profondità, limiti dei risultati e supporto dell’offset variano da endpoint a endpoint; usa la pagina dell’endpoint corrispondente come specifica della richiesta.
  • Google Organic SERP restituisce una query in tempo reale su una pagina di risultati; le metriche di parole chiave e siti sono segnali analitici e non vanno considerate lo stesso tipo di istantanea.
  • Righe restituite, singole metriche, osservazioni mensili, etichette di intento o punteggi di probabilità possono mancare quando i dati della fonte non sono disponibili.
  • Volume di ricerca, concorrenza a pagamento, difficoltà organica, traffico stimato e intento classificato sono segnali distinti e non punteggi intercambiabili.
  • Il campo extra conserva il contesto flessibile della fonte e non è uno schema normalizzato stabile.
  • Questi endpoint si autenticano con una chiave API di SocQ e non leggono i dati privati degli account Google Ads o Google Search Console.

Domande frequenti sull’API SEO

Che cos’è l’API SEO di SocQ?

L’API SEO di SocQ è un insieme di endpoint REST asincroni per aggiungere alle applicazioni l’intelligence sulla ricerca di Google, Bing e YouTube, con la stessa chiave API e lo stesso flusso di attività usati in tutta la piattaforma SocQ.

Che cosa copre la suite di API SEO di SocQ?

Copre risultati organici di Google, domanda e difficoltà delle parole chiave, scoperta di parole chiave, visibilità di siti e pagine, classificazione dell’intento di ricerca, Google News, Images e Autocomplete e posizionamenti su Bing e YouTube, tramite endpoint asincroni autenticati.

Quale endpoint SEO devo usare?

Usa Google Organic SERP per una pagina di risultati; Difficulty, Overview, Search Volume o Search Intent per elenchi di parole chiave già pronti; Suggestions o Related Keywords per espandere i termini di partenza; Keywords for Site, Ranked Keywords o Relevant Pages per la ricerca su domini e pagine; e News, Images, Autocomplete, Bing Search o YouTube Rank Tracker per queste superfici di ricerca. Le risposte AI sono coperte dalle API AI Search.

Servono le credenziali di Google Ads o di Search Console?

No. Le richieste si autenticano con la tua chiave API di SocQ e questi endpoint non accedono ai dati privati degli account Google Ads o Google Search Console.

Tutti i risultati dell’API SEO sono in tempo reale?

Google Organic SERP esegue una query in tempo reale su una pagina di risultati. Le metriche di parole chiave, intento, siti e pagine dipendono dalla disponibilità delle fonti e vanno interpretate in base all’endpoint selezionato.

Quanto costano gli endpoint SEO?

I prezzi sono specifici per endpoint. La pagina di ogni endpoint mostra se i crediti sono calcolati in base agli input inviati, a un costo fisso per richiesta o ai risultati restituiti.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.