API SimilarWeb Pubblico

Q: Cosa significano qui etichette di categoria come computers_electronics_and_technology?

Sono i nomi di categoria di SimilarWeb. In top_interested_categories indicano le categorie di contenuti che interessano di più ai visitatori del sito, che non coincidono con la categoria del sito stesso; quella arriva da SimilarWeb Search. Le etichette non sono mappate sulle categorie di altre piattaforme.

POST

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 un profilo stimato dei visitatori di un dominio su SimilarWeb. Ottieni ripartizione per genere, fasce d'età, altri siti e argomenti preferiti dai visitatori, tecnologie del sito e ripartizione tra ricerca organica e ricerca a pagamento. Sono stime aggregate con una data di rilevazione. Non identificano persone e non sono dati del sito stesso.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su similarweb e action impostato su audience. 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 Audience legge il profilo dei visitatori di un sito web, dato il suo dominio in keyword: la ripartizione tra visitatori uomini e donne, la distribuzione per età, gli altri siti che i suoi visitatori frequentano, gli argomenti e le categorie che li interessano di più, le tecnologie su cui gira il sito e le quote di traffico di ricerca organico e a pagamento. Risponde alla domanda su chi visita un sito, non su quanti lo visitano: i marketer la usano per verificare se un sito raggiunge i loro clienti target, per pianificare il media buying e le partnership e per valutare il pubblico di un concorrente.

Passa il dominio del sito, ad esempio facebook.com. I dati sono stime di SimilarWeb, non le analytics del sito stesso, e sono aggiornati con un certo ritardo, quindi controlla snapshot_date prima di considerare attuale un valore. Confrontando organic_traffic_share con paid_traffic_share vedi se un sito attira visitatori dai motori di ricerca grazie alla SEO oppure tramite campagne di ricerca a pagamento. Per numero di visite e ranking, chiama SimilarWeb Search con lo stesso dominio.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint SimilarWeb Pubblico di EveryInfra (similarweb/audience).

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 audience, 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.
- Restituisce un oggetto. Campi principali: id, url, name, male_share, female_share, age_distribution, top_interested_websites, top_interested_topics, top_interested_categories, technologies, organic_traffic_share, paid_traffic_share; 13 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=similarweb.
- Esempio di corpo della richiesta:
{
  "platform": "similarweb",
  "action": "audience",
  "params": {
    "keyword": "facebook.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ì	`audience`	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.

Esempi di codice

bash

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": "audience",
  "params": {
    "keyword": "facebook.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

json

{  "id": "req_…",  "platform": "similarweb",  "action": "audience",  "results": {    "id": "facebook.com",    "url": "https://facebook.com",    "name": "Facebook",    "male_share": 0,    "female_share": 0,    "age_distribution": [      {        "min_age": 25,        "max_age": 34,        "share": 0      },      {        "min_age": 35,        "max_age": 44,        "share": 0      },      {        "min_age": 45,        "max_age": 54,        "share": 0      }    ],    "top_interested_websites": [      "instagram.com",      "google.com",      "youtube.com"    ],    "top_interested_topics": [      "news",      "shopping",      "games"    ],    "top_interested_categories": [      "games/video_games_consoles_and_accessories",      "adult",      "computers_electronics_and_technology/programming_and_developer_software"    ],    "technologies": [      {        "category": "payment_and_currencies",        "top_tech": "Cart Functionality",        "tech_count": 33      },      {        "category": "advertising",        "top_tech": "Google Adsense",        "tech_count": 15      },      {        "category": "audio_video_media",        "top_tech": "YouTube",        "tech_count": 6      }    ],    "organic_traffic_share": 0,    "paid_traffic_share": 0,    "snapshot_date": "2026-08-01T00:00:00+00:00",    "platform": "similarweb"  },  "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à.
`male_share`	Mantiene il significato attribuito dalla piattaforma
`female_share`	Mantiene il significato attribuito dalla piattaforma
`age_distribution`	Mantiene il significato attribuito dalla piattaforma
`top_interested_websites`	Mantiene il significato attribuito dalla piattaforma
`top_interested_topics`	Mantiene il significato attribuito dalla piattaforma
`top_interested_categories`	Mantiene il significato attribuito dalla piattaforma
`technologies`	Mantiene il significato attribuito dalla piattaforma
`organic_traffic_share`	Mantiene il significato attribuito dalla piattaforma
`paid_traffic_share`	Mantiene il significato attribuito dalla piattaforma
`snapshot_date`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

In cosa differisce da SimilarWeb Search?

SimilarWeb Search descrive il traffico di un sito: ranking, visite stimate, coinvolgimento e provenienza delle visite. Audience descrive le persone dietro quelle visite: ripartizione per genere, età, interessi e altri siti che frequentano, oltre alla tecnologia del sito e al suo mix tra ricerca organica e a pagamento. Entrambe accettano lo stesso dominio in keyword.

Cosa significano qui etichette di categoria come computers_electronics_and_technology?

Sono i nomi di categoria di SimilarWeb. In top_interested_categories indicano le categorie di contenuti che interessano di più ai visitatori del sito, che non coincidono con la categoria del sito stesso; quella arriva da SimilarWeb Search. Le etichette non sono mappate sulle categorie di altre piattaforme.

`male_share` e `female_share` sono valori misurati?

No. Come gli altri dati qui, sono stime di SimilarWeb sulla composizione dei visitatori, non dati provenienti dalle analytics del sito. Usali per confrontare i siti tra loro, leggili insieme a age_distribution e conserva snapshot_date con ogni valore che salvi.

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.

Errori