Domain Overview
L’impronta di ricerca di un dominio è la sua presenza nei risultati di Google per un paese e una lingua, riassunta nel numero di parole chiave per cui si posiziona, nelle visite mensili che quei posizionamenti dovrebbero portare e in quanto costerebbe quel traffico in annunci, divisa tra organico e a pagamento e distribuita in fasce di posizione da 1 a 100, con il conteggio dei posizionamenti nuovi, in salita, in discesa e persi. Una sola riga di questi totali misura la portata di un concorrente, qualifica un potenziale cliente in base alla sua presenza nella ricerca e, salvata mese dopo mese, segue l’andamento della visibilità del proprio sito.
Funzionalità della Domain Overview API
- Un dominio in un mercato Googletarget accetta un dominio, mentre location e language scelgono paese e lingua dei risultati di ricerca, con Stati Uniti e inglese come predefiniti; la riga ripete location_code e language_code così le istantanee salvate restano etichettate.
- Organico e a pagamento con la stessa strutturaorganic e paid contengono lo stesso insieme di totali, così i posizionamenti non a pagamento e gli annunci di ricerca si confrontano campo per campo.
- Traffico con il suo valore pubblicitariokeywords_count conta le parole chiave posizionate, estimated_traffic indica le visite mensili che portano ed estimated_traffic_cost dà un prezzo a quel traffico in dollari USA secondo le tariffe di Google Ads.
- Dodici fasce di posizionepositions divide le parole chiave posizionate in pos_1, pos_2_3, pos_4_10 e altre fasce fino a pos_91_100, mostrando se un dominio conquista la prima pagina o resta più in basso nei risultati.
- Variazioni di ranking dall’ultimo aggiornamentonew_count, up_count, down_count e lost_count indicano quante parole chiave sono entrate, salite, scese o uscite dal ranking rispetto al precedente aggiornamento dei dati.
Parametri della Domain Overview API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
target | Obbligatorio | Dominio o sottodominio da analizzare, come notion.so; https:// e www. vengono rimossi, e un URL con un percorso viene rifiutato. |
location_code | Facoltativo | Codice numerico del paese di ricerca, come 2840 per gli Stati Uniti, che è il valore predefinito. Usa questo oppure location_name. |
location_name | Facoltativo | Nome del paese, come United States, in alternativa a location_code; se li invii entrambi devono indicare lo stesso paese. |
language_code | Facoltativo | Codice della lingua, come en, il valore predefinito; deve essere una delle lingue disponibili nel paese scelto. |
language | Facoltativo | Nome della lingua, come English, in alternativa a language_code; se li invii entrambi devono corrispondere. |
Come usare la Domain Overview API
Invia un dominio con il suo mercato e leggi la riga di panoramica quando l’attività è completata.
- Invia con POST {"target": "notion.so", "location_code": 2840, "language_code": "en"} a /v1/seo/domain-overview.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi l’unica riga di panoramica da results.items; results.next_cursor conta solo quando has_more è true.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","location_code":2840,"language_code":"en"}'
# One market per request, 5 credits.Casi d’uso della Domain Overview API
- Misurare la presenza di un concorrente nella ricerca: Leggi organic.keywords_count e organic.estimated_traffic per capire quanta parte di un mercato un rivale raggiunge già tramite Google.
- Seguire la propria visibilità mese per mese: Salva ogni mese le fasce di positions e i conteggi new, up, down e lost per vedere su un grafico se i posizionamenti salgono verso la prima pagina.
- Qualificare i potenziali clienti di un’agenzia: Usa organic.estimated_traffic_cost come valore in dollari del traffico di ricerca di un potenziale cliente quando decidi su quali account puntare.
- Verificare se un sito compra annunci di ricerca: paid.keywords_count e paid.estimated_traffic mostrano se un dominio pubblica annunci di ricerca Google nel mercato e quanto traffico portano.
- Confrontare un sito tra paesi diversi: Invia lo stesso dominio con impostazioni di location e language diverse per vedere in quali mercati è più forte.
Consigli degli esperti per la Domain Overview API
- Per un paese in cui l’inglese non è disponibile, imposta tu language_code o language, perché il valore predefinito en è accettato solo dove quel paese prevede l’inglese.
- Somma pos_1, pos_2_3 e pos_4_10 per ottenere il numero di parole chiave in prima pagina, perché le fasce sono intervalli separati che non si sovrappongono.
- Leggi i conteggi new, up, down e lost come variazioni rispetto al precedente aggiornamento dei dati, non rispetto alla tua ultima richiesta, e salva ogni riga con collected_at per costruire il tuo storico.
- Invia il dominio semplice; per i dati sulle singole pagine del sito usa Relevant Pages API, che riporta la distribuzione dei posizionamenti pagina per pagina.
API correlate
Oltre alla Domain Overview 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.
- Ranked Keywords API — Trova le parole chiave per cui si posizionano un dominio, un sottodominio o una pagina, con URL corrispondenti, posizioni, misurazioni di ricerca, intento ed elementi di origine completi.
- Competitor Domains API — Trova i domini posizionati sulle stesse parole chiave Google di un sito in un mercato, con keyword in comune, posizione media, traffico sulla sovrapposizione e totali di ricerca completi.
- Traffic Estimate API — Stima le visite mensili di ricerca Google organiche e a pagamento e il numero di parole chiave di fino a 1.000 domini in un mercato.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API