La piattaforma SEO di SocQ è nata con la ricerca di keyword e i risultati organici di Google. Il 2026-11-17 ha aggiunto quattordici endpoint che coprono il resto di un tipico flusso di lavoro SEO: chi linka un sito, quanto traffico di ricerca riceve un dominio e con chi compete, su quali tecnologie gira un sito e chi l'ha registrato, e cosa mostrano Google News, Google Images, Bing, YouTube e Google Autocomplete per una query.
Sono API di dati SEO, non una piattaforma social, quindi questa guida le raggruppa per attività. Per ogni endpoint trovi una richiesta, il prezzo e quando usarlo.
Risposta rapida: invia un dominio in
target(o un elenco intargets) oppure unaquerydi ricerca aPOST /v1/seo/...conAuthorization: Bearer $SOCQ_API_KEY. InterrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items. I prezzi vanno da 0.03 crediti per risultato immagine a 10 crediti per ricerca di backlink; un credito vale $0.005.
I quattordici nuovi endpoint SEO
| Attività | Endpoint | Cosa restituisce | Prezzo |
|---|---|---|---|
| Backlink | Backlinks Summary | Rank, backlink, domini di riferimento, spam score, ripartizioni dei link | 10 crediti ($0.05) per chiamata |
| Backlink | Backlinks | Singoli link con pagina di origine, anchor, dofollow, punteggi di autorità, date | 10 crediti ($0.05) + 0.02 ($0.0001) per link |
| Backlink | Referring Domains | Domini che linkano con rank, numero di backlink, spam score, data di prima rilevazione | 10 crediti ($0.05) + 0.02 ($0.0001) per dominio |
| Backlink | Backlink Competitors | Domini che condividono il maggior numero di domini di riferimento | 10 crediti ($0.05) + 0.02 ($0.0001) per dominio |
| Domini | Domain Overview | Keyword organiche e a pagamento, traffico, costo del traffico, fasce di posizione | 5 crediti ($0.025) per chiamata |
| Domini | Competitor Domains | Concorrenti su Google con keyword condivise, posizione media, traffico | 0.1 crediti ($0.0005) per dominio, minimo 3 ($0.015) |
| Domini | Traffic Estimate | Traffico organico e a pagamento per un massimo di 1,000 domini | 3 crediti ($0.015) + 0.1 ($0.0005) per dominio |
| Profilo del sito | Domain Technologies | Tecnologie rilevate, profili social, contatti pubblicati | 5 crediti ($0.025) per chiamata |
| Profilo del sito | Whois Lookup | Registrar, date di registrazione e scadenza, stati, name server | 5 crediti ($0.025) per chiamata |
| Risultati di ricerca | Google News | Articoli con titolo, snippet, editore, orario, link diretto | 0.1 crediti ($0.0005) per articolo |
| Risultati di ricerca | Google Images | Immagine a grandezza piena, miniatura, titolo, testo alternativo, pagina che la ospita | 0.03 crediti ($0.00015) per immagine |
| Risultati di ricerca | Bing Search | Risultati organici con titolo, snippet, URL, dominio | 0.1 crediti ($0.0005) per risultato |
| Risultati di ricerca | YouTube Rank Tracker | Video in classifica con canale, visualizzazioni, durata, data di pubblicazione | 0.5 crediti ($0.0025) per video |
| Risultati di ricerca | Google Autocomplete | I completamenti di Google per l'inizio di una query | 0.5 crediti ($0.0025) per chiamata |
Ricerca di backlink
Tutti e quattro accettano in target un dominio, un sottodominio o l'URL di una pagina; se il target è un dominio, i sottodomini sono inclusi. Gli endpoint a elenco addebitano una base di 10 crediti per la ricerca più 0.02 crediti per riga, con results_limit da 1 a 1,000 (predefinito 100).
L'API Backlinks Summary descrive il profilo di link in una sola riga: rank di autorità, backlink, domini e IP di riferimento, quota di nofollow, link interrotti, spam score, data di prima rilevazione e ripartizioni per TLD, paese, tipo di link e posizionamento. Usala prima di un audit più approfondito (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/backlinks-summary" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.so"}'
L'API Backlinks elenca i singoli link, dal più forte: pagina che linka e relativo titolo, pagina di destinazione, anchor, tipo di link, attributi dofollow e rel, autorità di link, pagina e dominio, spam score, posizionamento e date di prima e ultima rilevazione (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/backlinks" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.so", "results_limit": 100}'
L'API Referring Domains conta i domini invece dei singoli link: ognuno ha rank, backlink, pagine che linkano, pagine nofollow, link interrotti, spam score, data di prima rilevazione e lost_at. È il modo più chiaro per individuare siti che linkano nuovi o persi e costruire liste di outreach (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/referring-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.so", "results_limit": 100}'
L'API Backlink Competitors trova i siti che competono per gli stessi link, ordinati per domini di riferimento condivisi. È lì che cerchi i link gap e i siti per i guest post (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/backlink-competitors" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.so", "results_limit": 50}'
Traffico e concorrenti dei domini
Questi tre accettano un paese e una lingua: location_code (o location_name) e language_code (o language), con Stati Uniti (2840) e inglese (en) come valori predefiniti. La lingua deve essere disponibile nel paese scelto.
L'API Domain Overview restituisce la presenza di un dominio su Google in un mercato: numero di keyword organiche e a pagamento, traffico mensile stimato e il suo costo pubblicitario, fasce di posizione da 1 a 100 e posizionamenti nuovi, in salita, in discesa e persi (documentazione).
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"}'
L'API Competitor Domains mostra contro chi competi davvero su Google: keyword condivise, posizione media e traffico su quelle keyword, più i totali organici e a pagamento di ogni rivale. results_limit va da 1 a 1,000 (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/competitor-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.so", "location_code": 2840, "language_code": "en", "results_limit": 100}'
L'API Traffic Estimate misura molti siti in una volta: invia fino a 1,000 domini in targets e ottieni per ciascuno traffico organico e a pagamento e numero di keyword. Usala per dare priorità ai prospect o arricchire un CRM (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/traffic-estimate" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"targets": ["notion.so", "figma.com", "canva.com"], "location_code": 2840, "language_code": "en"}'
Profilo del sito: tecnologie e Whois
L'API Domain Technologies elenca ogni tecnologia rilevata con categoria e gruppo (CDN, analytics, framework, strumenti di e-commerce), più titolo, rank, paese, lingua, profili social ed email e numeri di telefono pubblicati. Per un dominio che reindirizza, usa la destinazione, ad esempio notion.com per notion.so (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/domain-technologies" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "notion.com"}'
L'API Whois Lookup restituisce il record di registrazione attuale: registrar e ID IANA, date di registrazione, aggiornamento e scadenza, codici di stato, name server, DNSSEC e, se indicati, organizzazione e paese del registrante. Copre le estensioni generiche e quelle nazionali come .uk e .ai (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/whois" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"target": "github.com"}'
Risultati di ricerca oltre Google Web
Tutti e cinque accettano una query e usano come predefiniti Stati Uniti (2840) e inglese (en).
L'API Google News mantiene l'ordine di Google con le notizie principali in testa; ogni articolo ha titolo, snippet, editore, orario di pubblicazione e un link diretto all'editore, non un redirect di Google. results_limit: da 1 a 200, predefinito 10 (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/google-news" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "nvidia", "location_code": 2840, "language_code": "en", "results_limit": 10}'
L'API Google Images restituisce URL dell'immagine a grandezza piena, miniatura, titolo, testo alternativo e pagina che la ospita. Verifica se le foto dei tuoi prodotti si posizionano o trova i siti che riusano le tue immagini. results_limit: da 1 a 700, predefinito 100 (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/google-images" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "modern living room", "results_limit": 100}'
L'API Bing Search restituisce in ordine i risultati organici di Bing con titolo, snippet, URL e dominio, seguendo i risultati mobile di Bing. results_limit: da 1 a 200, predefinito 10 (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/bing-organic-serp" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "best crm software", "location_code": 2840, "language_code": "en", "results_limit": 10}'
L'API YouTube Rank Tracker elenca i video che YouTube posiziona per una query in un mercato, con titolo, canale, visualizzazioni, durata, miniatura e data di pubblicazione. results_limit: da 1 a 200, predefinito 20 (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/youtube-serp" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "crm tutorial", "location_code": 2840, "language_code": "en", "results_limit": 20}'
L'API Google Autocomplete restituisce i completamenti di Google per l'inizio di una ricerca, nell'ordine mostrato, di solito circa 15. Usala per keyword long tail e argomenti per le FAQ (documentazione).
curl -X POST "https://api.socq.ai/v1/seo/google-autocomplete" \
-H "Authorization: Bearer $SOCQ_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "best crm", "location_code": 2840, "language_code": "en"}'
Per i posizionamenti web su Google e le metriche delle keyword, usa gli endpoint già esistenti Google Organic SERP e Keyword Overview. Trovi tutto nella pagina della piattaforma SEO.
Autenticazione e flusso asincrono dei task
Ogni richiesta invia Authorization: Bearer YOUR_API_KEY e Content-Type: application/json. Ogni invio avvia un task in background (submit -> task_id -> queued -> running -> succeeded, oppure failed) e restituisce data.task_id e data.status. Interrogalo:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Finché è queued, running o failed, la risposta contiene solo i metadati del task; in caso di failed, leggi error_message. Con succeeded, include la prima pagina di record in data.results.items. limit vale 50 per impostazione predefinita, massimo 500; finché has_more è true, passa results.next_cursor come cursor. fields accetta fino a 50 campi o percorsi con punto. Un timeout del client non annulla il task, quindi riprendi con lo stesso task_id invece di pagare due volte. Aggiungi callback_url al corpo dell'invio per ricevere una POST con il riepilogo del task al termine.
Quanto costa un lavoro tipico
- Audit dei link (summary, 1,000 backlink, 1,000 domini di riferimento): 10 + 30 + 30 = 70 crediti, $0.35.
- Traffic Estimate per 1,000 domini: 3 + 100 = 103 crediti, $0.515.
- 100 risultati di Google Images: 3 crediti, $0.015.
FAQ
Quali paesi supportano gli endpoint sui domini?
Domain Overview, Competitor Domains e Traffic Estimate accettano un elenco fisso di paesi, con inglese USA come predefinito. Il loro supporto per paese è diverso da quello degli endpoint SERP in tempo reale, e il location code 2156 non è disponibile.
Perché una ricerca di backlink costa 10 crediti anche con pochi risultati?
Gli endpoint a elenco addebitano una base di 10 crediti per la ricerca, poi 0.02 crediti per riga. Un risultato vuoto costa solo la base.
Gli endpoint dei risultati di ricerca hanno un costo base?
No. Google News, Google Images, Bing Search e YouTube Rank Tracker addebitano solo per risultato restituito. Google Autocomplete costa un fisso di 0.5 crediti per chiamata.
Bing Search include annunci o altre funzionalità?
Copre i risultati organici di Bing, seguendo i risultati mobile di Bing.
Dove sono gli endpoint di ricerca AI?
Le menzioni negli LLM e Google AI Mode ora si trovano nella pagina della piattaforma AI Search, separata. Le tariffe attuali di tutto sono nella pagina dei prezzi.
SEO API
Prova il flusso di lavoro con un URL pubblico di SEO
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di SEO