API SimilarWeb Ricerca
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Visualizza una panoramica del traffico di un dominio da SimilarWeb. Ottieni posizione globale, nazionale e di categoria, visite mensili stimate, frequenza di rimbalzo, sorgenti di traffico e paesi principali. Passa un dominio come example.com, non un termine di ricerca. I dati sono stime basate su modelli con una data di rilevazione, non analytics del sito stesso.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su similarweb e action impostato su search. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
SimilarWeb Search legge la panoramica del traffico di un sito web, a partire dal dominio in keyword. Restituisce ranking globale, per paese e per categoria, visite mensili stimate, frequenza di rimbalzo, pagine per visita e durata media della visita. Indica anche i paesi, i termini di ricerca, i siti di riferimento e i social network che portano traffico, la ripartizione delle fonti di traffico, i concorrenti elencati da SimilarWeb e alcune informazioni di base sull'azienda dietro il sito. Marketer, investitori e team commerciali la usano per valutare un sito, confrontarlo con i concorrenti e capire da dove arrivano i visitatori.
Nonostante il nome, non cerca un termine sul web: passa un dominio come example.com. I dati sono stime del modello di SimilarWeb, non gli analytics del sito, quindi confronta i siti tra loro e non con i tuoi numeri. Un numero di ranking più basso è migliore. bounce_rate è una quota, quindi 0.6 significa 60%. avg_visit_duration è in secondi.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint SimilarWeb Ricerca di EveryInfra (similarweb/search).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su similarweb e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Specifica il dominio da analizzare (ad esempio example.com), non una parola chiave di ricerca generica.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe.
- Restituisce un elenco di record. Campi principali di ogni record: id, url, name, text, category, global_rank (Posizione nella classifica globale del…), country_rank (Posizione nella classifica del traffico…), category_rank (Posizione nella classifica del traffico…), country, monthly_visits, bounce_rate, pages_per_visit; 29 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=similarweb.
- Esempio di corpo della richiesta:
{
"platform": "similarweb",
"action": "search",
"params": {
"keyword": "example.com"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | similarweb | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Specifica il dominio da analizzare (ad esempio example.com), non una parola chiave di ricerca generica. A seconda dell'azione scelta, questo parametro recupera una panoramica del traffico per search, elenca siti simili per competitors o estrae il profilo dei visitatori del dominio per audience. Le metriche restituite sono stime di terze parti e non riflettono le misurazioni interne di GA4. |
limit | body.params | integer (1–) | No | - | Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "similarweb",
"action": "search",
"params": {
"keyword": "example.com"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "similarweb", "action": "search", "results": [ { "id": "example.com", "url": "https://www.similarweb.com/website/example.com", "name": "example.com", "text": "", "category": "computers_electronics_and_technology/programming_and_developer_software", "global_rank": 7941, "country_rank": 12471, "category_rank": 280, "monthly_visits": 9345666, "bounce_rate": 0.6514912791710534, "avg_visit_duration": "00:02:30", "top_countries": [ { "countryAlpha2Code": "US", "countryAlpha2CodeRaw": "US", "countryUrlCode": "united-states", "visitsShare": 0.1329426107445016, "visitsShareChange": 0.23721803817648812 }, { "countryAlpha2Code": "GB", "countryAlpha2CodeRaw": "GB", "countryUrlCode": "united-kingdom", "visitsShare": 0.09609787381537664, "visitsShareChange": 0.748813150577166 }, { "countryAlpha2Code": "IN", "countryAlpha2CodeRaw": "IN", "countryUrlCode": "india", "visitsShare": 0.0812021419465102, "visitsShareChange": 0.2577621588969865 } ], "top_keywords": [ { "name": "www.example.com", "estimatedValue": null, "volume": null, "cpc": null }, { "name": "example.com", "estimatedValue": null, "volume": null, "cpc": 0.71 }, { "name": "price comparison", "estimatedValue": null, "volume": null, "cpc": 1.64 } ], "traffic_sources": [ { "source": "ads", "rank": 1, "percentage": 0.464616847938312, "isHigher": null }, { "source": "direct", "rank": 2, "percentage": null, "isHigher": null }, { "source": "referrals", "rank": 3, "percentage": null, "isHigher": null } ], "top_referrals": [ { "domain": "", "icon": "", "visitsShare": 0.23747686624030057, "isLocked": true, "isAvailable": true }, { "domain": "", "icon": "", "visitsShare": 0.04233750061365961, "isLocked": true, "isAvailable": true }, { "domain": "", "icon": "", "visitsShare": 0.03883400072797977, "isLocked": true, "isAvailable": true } ], "social_distribution": [ { "name": "Reddit", "visitsShare": 0.3005705760443808, "icon": "https://site-images.similarcdn.com/image?url=reddit.com&t=2&s=1&h=66f2412047e0362ec60d5583d4b186511a8e859446bb112c60d22968facae906" }, { "name": "Youtube", "visitsShare": 0.1996099164167749, "icon": "https://site-images.similarcdn.com/image?url=youtube.com&t=2&s=1&h=e117fb09ba0a34dee9830863bf927d29fc864e342583a36a667bf12346e88e20" }, { "name": "Pinterest", "visitsShare": 0.12311561331673827, "icon": "https://site-images.similarcdn.com/image?url=pinterest.com&t=2&s=1&h=ec976160ca16242c6ab9ed7bc48e7b0f04c4100ceac5bcb6d3ea55450aa12210" } ], "competitors": [ "simplilearn.com", "pennfoster.edu", "mygreatlearning.com" ], "snapshot_date": "2026-08-01T00:00:00+00:00", "platform": "similarweb" } ], "count": 1, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
url | Link al record sulla piattaforma. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
category | Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme. |
global_rank | Posizione nella classifica globale del traffico; un numero più basso indica una posizione più alta. |
country_rank | Posizione nella classifica del traffico nel suo paese. |
category_rank | Posizione nella classifica del traffico all'interno della sua categoria. |
country | Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato. |
monthly_visits | Mantiene il significato attribuito dalla piattaforma |
bounce_rate | Mantiene il significato attribuito dalla piattaforma |
pages_per_visit | Mantiene il significato attribuito dalla piattaforma |
avg_visit_duration | Mantiene il significato attribuito dalla piattaforma |
company_name | Mantiene il significato attribuito dalla piattaforma |
company_founded | Mantiene il significato attribuito dalla piattaforma |
company_employees_min | Mantiene il significato attribuito dalla piattaforma |
company_employees_max | Mantiene il significato attribuito dalla piattaforma |
company_hq_country | Mantiene il significato attribuito dalla piattaforma |
company_hq_city | Mantiene il significato attribuito dalla piattaforma |
top_countries | Mantiene il significato attribuito dalla piattaforma |
top_keywords | Mantiene il significato attribuito dalla piattaforma |
traffic_sources | Mantiene il significato attribuito dalla piattaforma |
top_referrals | Mantiene il significato attribuito dalla piattaforma |
social_distribution | Mantiene il significato attribuito dalla piattaforma |
competitors | Mantiene il significato attribuito dalla piattaforma |
snapshot_date | Mantiene il significato attribuito dalla piattaforma |
email | Indirizzo email di contatto, passato così com'è. |
emails | Indirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati. |
phone | Numero di telefono di contatto, passato senza normalizzarne il formato. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Perché keyword accetta un dominio?
#Perché questa funzionalità analizza un singolo sito web invece di cercare sul web. Passa il dominio del sito, ad esempio example.com. Lo stesso input funziona per le funzionalità SimilarWeb Competitors e Audience, che restituiscono i siti simili e il profilo dei visitatori di quel sito, quindi un solo elenco di domini può alimentarle tutte e tre.
Cosa significano valori di categoria come computers_electronics_and_technology?
#category è la categoria del sito nella tassonomia di SimilarWeb, quindi un valore come computers_electronics_and_technology è un'etichetta di SimilarWeb, non un codice condiviso con altre piattaforme. category_rank è il ranking di traffico del sito all'interno di quella categoria, e per i siti di nicchia è un termine di confronto più equo di global_rank.
Quanto sono aggiornati i dati sul traffico?
#Controlla snapshot_date: è la data dello snapshot da cui provengono i dati. I dati sul traffico arrivano in ritardo, quindi non leggere monthly_visits come un conteggio in tempo reale del mese corrente. Quando monitori un sito nel tempo, salva ogni risultato con il suo snapshot_date e confronta gli snapshot, non le date delle chiamate.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Similarweb: visite, visitatori unici e metriche di engagement ↗
Similarweb distingue le visite mensili dai visitatori unici mensili e misura separatamente durata, pagine per visita e frequenza di rimbalzo. Questa azione non accetta come parametri i filtri per data, dispositivo e sottodominio, e monthly_visits non può essere usato come approssimazione del numero di visitatori unici.
Verificato il 2026-09-04