Riferimento API Similarweb | Documentazione API

# SimilarwebAPI endpoint reference

All 27 SimilarwebAPI GET endpoints with exact query names, types, limits, date windows, and response behavior.

All paths below are relative to your API origin. Every request requires `Authorization: Bearer YOUR_API_KEY`, uses GET, and has no request body. See [authentication, billing, and errors](https://apihop.ai/en/docs/api-reference/similarweb/overview).

## Query Rules

The singular website fields `key` and `Key` require one ASCII domain such as `amazon.com`, up to 253 characters, without surrounding whitespace. Do not send a URL, IP address, domain list, or API credential in these fields. Use punycode for internationalized domains.

Query names are case-sensitive. Unknown fields, duplicate fields, CR/LF/NUL, and invalid values are rejected. Boolean values are literal `true` or `false`; zero is not interchangeable with false. Text is 1-2048 UTF-8 bytes after trimming. Encode spaces, JSON arrays, and separators with your HTTP client's query encoder.

`from` and `to` must occur together, be real calendar dates in `YYYY-MM-DD` or `YYYY|MM|DD` format, and satisfy `from <= to`. A comparison pair follows the same rule. Optional fields inherit endpoint defaults; the tables list allowed fields, not a requirement to send all of them.

For endpoints that accept dates, a valid, complete explicit `from`/`to` range takes precedence. On endpoints that accept `latest`, a supplied value must still pass the existing format and endpoint-specific validation, but is ignored for range selection and is not sent to Similarweb; no default `latest` is added. Without an explicit range, existing `latest`, default and window behavior is unchanged. History restrictions still apply, and endpoints that do not accept `latest` still reject it.

Without an explicit `from`/`to` range: Window-based routes normally default to 28 days ending three UTC days ago and accept `latest=1d` through `366d`. Fixed-month routes have the defaults noted below. Engagement, visits, ranks, and channels additionally accept `latest=1m|2m|3m|6m` for previous complete UTC calendar months; these selectors require `isWindow=false` and default `timeGranularity=Monthly`. History has the narrower rules documented for its four endpoints.

Only worldwide data is supported (`country=999`). Website identifiers are domains such as `example.com`, except the keyword-ranking endpoint where `keys` is a search keyword. Upstream data availability, filters, and matching types may vary. Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data.

Successful responses preserve native JSON rather than adopting a universal response schema. Incoming and outgoing referral tables use `Records`; historical metrics may use nested `Data`. The names and units described below do not imply every optional upstream field is always present.

## Endpoints

### Keyword suggestions

`GET https://api.apihop.ai/v1/similarweb/keywords/suggestions`

Defaults: country 999, latest 28d, rowsPerPage 100, type Broad, websource Total, and windowVolume descending. Optional page is 1-based. rangeFilter uses native syntax, for example volume,100,10000|difficulty,0,40. Matching-type and filter availability depend on the data source. Only worldwide data is supported (`country=999`).

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `keyword` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `from` | No | string; valid date using the formats above |
| `to` | No | string; valid date using the formats above |
| `latest` | No | string; 1-2048 UTF-8 bytes after trimming |
| `sort` | No | string; 1-2048 UTF-8 bytes after trimming |
| `asc` | No | boolean string: true or false |
| `page` | No | integer string; 1-1000 |
| `rowsPerPage` | No | integer string; 1-1000 |
| `type` | No | string; enum: Broad, Phrase, Exact, Related |
| `websource` | No | string; enum: Total, Desktop, MobileWeb |
| `isWindow` | No | boolean string: true or false |
| `rangeFilter` | No | string; 1-2048 UTF-8 bytes after trimming |

### Backlinks

`GET https://api.apihop.ai/v1/similarweb/websites/backlinks`

Defaults: Page 1, PageSize 100, Status All, FollowType All, and DomainScore descending. Key is capitalized; do not use key or keys.

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `Key` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `Page` | No | integer string; 1-1000 |
| `PageSize` | No | integer string; 1-1000 |
| `Status` | No | string; enum: All, Active, New, Lost |
| `FollowType` | No | string; enum: All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow |
| `DomainScoreFrom` | No | integer string; 0-100 |
| `DomainScoreTo` | No | integer string; 0-100 |
| `sort` | No | string; 1-2048 UTF-8 bytes after trimming |
| `asc` | No | boolean string: true or false |

### Website keywords

`GET https://api.apihop.ai/v1/similarweb/websites/keywords`

Defaults: page 1, pageSize 100, sourceType all, and both branded flags false. pageFilterJson is one URL-encoded JSON array string; when omitted it targets keys as a domain. Without an explicit `from`/`to` range: latest=1m selects the one-month overview mode with pageSize 5 and isWindow=false unless explicitly provided. Use sourceType=organic or paid with IncludeNoneBranded=true and IncludeBranded=false for non-branded keyword views.

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `keys` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `from` | No | string; valid date using the formats above |
| `to` | No | string; valid date using the formats above |
| `includeSubDomains` | No | boolean string: true or false |
| `isWindow` | No | boolean string: true or false |
| `webSource` | No | string; enum: Total, Desktop, MobileWeb |
| `timeGranularity` | No | string; enum: Daily, Monthly |
| `latest` | No | string; 1-2048 UTF-8 bytes after trimming |
| `sort` | No | string; 1-2048 UTF-8 bytes after trimming |
| `asc` | No | boolean string: true or false |
| `iso` | No | string; 1-2048 UTF-8 bytes after trimming |
| `isDaily` | No | boolean string: true or false |
| `IncludeBranded` | No | boolean string: true or false |
| `IncludeNoneBranded` | No | boolean string: true or false |
| `page` | No | integer string; 1-1000 |
| `pageSize` | No | integer string; 1-1000 |
| `sourceType` | No | string; 1-2048 UTF-8 bytes after trimming |
| `pageFilterJson` | No | string containing a JSON array |

### Keyword ranking websites

`GET https://api.apihop.ai/v1/similarweb/keywords/websites`

keys is a keyword, not a website domain. Defaults include selectedPageTab=Organic, sourceType=organic, Device=Total, and graphDuration=28d. Optional page and pageSize use 1-based/positive integers.

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `keys` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `from` | No | string; valid date using the formats above |
| `to` | No | string; valid date using the formats above |
| `includeSubDomains` | No | boolean string: true or false |
| `isWindow` | No | boolean string: true or false |
| `webSource` | No | string; enum: Total, Desktop, MobileWeb |
| `timeGranularity` | No | string; enum: Daily, Monthly |
| `latest` | No | string; 1-2048 UTF-8 bytes after trimming |
| `sort` | No | string; 1-2048 UTF-8 bytes after trimming |
| `asc` | No | boolean string: true or false |
| `iso` | No | string; 1-2048 UTF-8 bytes after trimming |
| `isDaily` | No | boolean string: true or false |
| `tab` | No | nonnegative integer string |
| `mtd` | No | boolean string: true or false |
| `selectedPageTab` | No | string; enum: Organic, Paid |
| `graphDuration` | No | string; 1-2048 UTF-8 bytes after trimming |
| `graphType` | No | integer string; 1-1000 |
| `isDurationChanged` | No | boolean string: true or false |
| `ignoreFilterConsistency` | No | boolean string: true or false |
| `Device` | No | string; 1-2048 UTF-8 bytes after trimming |
| `sourceType` | No | string; 1-2048 UTF-8 bytes after trimming |
| `page` | No | integer string; 1-1000 |
| `pageSize` | No | integer string; 1-1000 |

### Traffic sources

`GET https://api.apihop.ai/v1/similarweb/websites/traffic-sources`

Defaults: sourceType=Referral, page=1, orderBy=Share desc, and timeGranularity=Daily. This table is distinct from the incoming-referrals endpoint.

### Outgoing traffic

`GET https://api.apihop.ai/v1/similarweb/websites/outgoing-traffic`

from and to are required. Singular key only. Defaults: country=999, isWWW=false, isWindow=false, webSource=Total, page=1, orderby=Share desc, orderBy=Share desc, sort=Share, asc=false. orderby and orderBy are distinct and forwarded independently; keep them consistent. No latest, pageSize, rowsPerPage, includeSubDomains, or timeGranularity. Rows are in Records; TotalCount is the upstream total, not the current page length. Only worldwide data is supported (`country=999`).

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `key` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `from` | Yes | string; valid date using the formats above |
| `to` | Yes | string; valid date using the formats above |
| `isWWW` | No | boolean string: true or false |
| `isWindow` | No | boolean string: true or false |
| `webSource` | No | string; enum: Total, Desktop, MobileWeb |
| `orderby` | No | string; 1-2048 UTF-8 bytes after trimming |
| `orderBy` | No | string; 1-2048 UTF-8 bytes after trimming |
| `sort` | No | string; 1-2048 UTF-8 bytes after trimming |
| `asc` | No | boolean string: true or false |
| `page` | No | integer string; 1-1000 |

### Incoming referrals

`GET https://api.apihop.ai/v1/similarweb/websites/incoming-referrals`

Singular key only. Defaults: country=999, latest=28d, isWWW=false, isWindow=true, isDaily=false, webSource=Total, selectedTab=incomingTraffic, orderBy=TotalShare desc, ignoreFilterConsistency=false, page=1. No keys, pageSize, rowsPerPage, includeSubDomains, or timeGranularity. Rows are in Records; native fields may include SiteOrigins and TotalShare. Only worldwide data is supported (`country=999`).

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `key` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `from` | No | string; valid date using the formats above |
| `to` | No | string; valid date using the formats above |
| `isWWW` | No | boolean string: true or false |
| `iso` | No | string; 1-2048 UTF-8 bytes after trimming |
| `isWindow` | No | boolean string: true or false |
| `isDaily` | No | boolean string: true or false |
| `latest` | No | string; 1-2048 UTF-8 bytes after trimming |
| `webSource` | No | string; enum: Total, Desktop, MobileWeb |
| `selectedTab` | No | string; enum: incomingTraffic |
| `orderBy` | No | string; 1-2048 UTF-8 bytes after trimming |
| `ignoreFilterConsistency` | No | boolean string: true or false |
| `page` | No | integer string; 1-1000 |

### Branded keyword share

`GET https://api.apihop.ai/v1/similarweb/websites/branded-keywords`

Defaults to the previous complete UTC month. duration is fixed to 1m.

### Traffic geography

`GET https://api.apihop.ai/v1/similarweb/websites/geography`

Defaults to the previous three complete UTC months, pageSize=5 and orderBy=TotalShare desc.

### Device distribution

`GET https://api.apihop.ai/v1/similarweb/websites/devices`

Defaults to the previous three complete UTC months and ShouldGetVerifiedData=false.

### Search performance

`GET https://api.apihop.ai/v1/similarweb/websites/search-performance`

Defaults to the previous complete UTC month, pageSize=5, duration=1m and SourceType=Organic. Use SourceType=Paid for paid keywords; do not substitute sourceType.

### Social traffic

`GET https://api.apihop.ai/v1/similarweb/websites/social-traffic`

Defaults to the previous three complete UTC months. webSource is not accepted.

### Engagement overview

`GET https://api.apihop.ai/v1/similarweb/websites/engagement`

Defaults include ShouldGetVerifiedData=false, includeLeaders=true and unBounced=false. Native Data rows may contain AvgMonthVisits, BounceRate, PagesPerVisit and AvgVisitDuration.

### Total visits

`GET https://api.apihop.ai/v1/similarweb/websites/visits`

compareFrom and compareTo must be supplied together as valid ordered dates. timeGranularity is Monthly. Native fields may include TotalVisits, Change and ShareOfVisits; a rolling total is not necessarily a complete-calendar-month total.

### Visits table

`GET https://api.apihop.ai/v1/similarweb/websites/visits/table`

compareFrom and compareTo must be supplied together as valid ordered dates. timeGranularity is Monthly; rows are in `Data`, with `Domain` and `TotalVisits`. `TotalCount` can be 0 even when `Data` contains rows; inspect the array itself to determine whether results are present.

### Visits trend

`GET https://api.apihop.ai/v1/similarweb/websites/visits/trend`

Defaults to the rolling 28-day daily window. timeGranularity accepts Daily, Weekly or Monthly.

### Website ranks

`GET https://api.apihop.ai/v1/similarweb/websites/ranks`

timeGranularity is Monthly. Native response uses distinct GlobalRank, CountryRank and CategoryRank objects.

### Country ranks

`GET https://api.apihop.ai/v1/similarweb/websites/ranks/country`

timeGranularity is Monthly. This is the explicit country-rank table, not the combined ranks response. Rows are in `Data`, with `Domain` and `Rank`. `TotalCount` can be 0 even when rows are present; inspect `Data` directly.

### Global ranks

`GET https://api.apihop.ai/v1/similarweb/websites/ranks/global`

timeGranularity is Monthly. This returns the separate global-rank table. Rows are in `Data`, with `Domain` and `Rank`. `TotalCount` can be 0 even when rows are present; inspect `Data` directly.

### Category ranks

`GET https://api.apihop.ai/v1/similarweb/websites/ranks/category`

timeGranularity is Monthly. This returns the separate industry/category-rank table. Rows are in `Data`, with `Domain` and `Rank`. `TotalCount` can be 0 even when rows are present; inspect `Data` directly.

### Traffic channels

`GET https://api.apihop.ai/v1/similarweb/websites/channels`

Defaults to the rolling 28-day daily window. With `webSource=Total`, channel values are under `Data.Total[domain]`, not directly under `Data[domain]`. Channel names are preserved, for example `Search - Organic` and `Direct`. Values are visit counts; derive shares only when their sum is positive.

### Similar sites

`GET https://api.apihop.ai/v1/similarweb/websites/similar-sites`

Defaults to the previous three complete UTC months. isWindow must be false, timeGranularity is Monthly, and orderBy is fixed to Affinity desc. No latest or webSource.

### Similar site suggestions

`GET https://api.apihop.ai/v1/similarweb/websites/similar-sites/suggestions`

Singular key; limit defaults to 20 and must be 1-20. country defaults to 999 and webSource to Total. The observed native response is an unwrapped array of candidates containing `Domain`, `DomainWithoutSub`, numeric `Rank`, and `Favicon`; do not expect a `Data` envelope. An empty array contains no suggestions. Only worldwide data is supported (`country=999`).

| Query field | Required | Type and constraints |
| --- | --- | --- |
| `key` | Yes | string; 1-2048 UTF-8 bytes after trimming |
| `limit` | No | integer string; 1-20 |
| `country` | No | nonnegative integer string; Only worldwide data is supported (`country=999`). Other valid country values are changed to `999` before the upstream request and return worldwide, not country-specific, data. |
| `webSource` | No | string; enum: Total, Desktop, MobileWeb |

### Monthly visits history

`GET https://api.apihop.ai/v1/similarweb/websites/history/visits`

Defaults to the previous six complete UTC months. Only country=999, isWindow=false and timeGranularity=Monthly are supported. latest accepts 1m through 6m; explicit dates must be complete months inside that rolling six-month window. Native series may appear under Data.<domain>.<source> with Key/Value points; source names, including MobileWeb or Mobile Web, are preserved. Values represent estimated visits.

### Monthly bounce rate history

`GET https://api.apihop.ai/v1/similarweb/websites/history/bounce-rate`

### Monthly visit duration history

`GET https://api.apihop.ai/v1/similarweb/websites/history/visit-duration`

### Monthly pages per visit history

`GET https://api.apihop.ai/v1/similarweb/websites/history/pages-per-visit`

Tutti i percorsi seguenti sono relativi all'origine della tua API. Ogni richiesta richiede Authorization: Bearer YOUR_API_KEY, usa GET e non ha un corpo. Vedi autenticazione, fatturazione ed errori.

Regole delle query

I campi singolari per il sito web key e Key richiedono un unico dominio ASCII come amazon.com, lungo al massimo 253 caratteri, senza spazi iniziali o finali. Non inviare URL, indirizzi IP, elenchi di domini o credenziali API in questi campi. Usa punycode per i domini internazionalizzati.

I nomi dei parametri distinguono maiuscole e minuscole. Campi sconosciuti o duplicati, CR/LF/NUL e valori non validi vengono rifiutati. I valori booleani sono i letterali true o false; zero non è intercambiabile con false. Il testo deve contenere 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni. Codifica spazi, array JSON e separatori con il codificatore di query del tuo client HTTP.

from e to devono comparire insieme, essere date di calendario reali nel formato YYYY-MM-DD o YYYY|MM|DD e soddisfare from <= to. La stessa regola vale per una coppia di confronto. I campi facoltativi ereditano i valori predefiniti dell'endpoint; le tabelle elencano i campi ammessi, non impongono di inviarli tutti.

Negli endpoint che accettano date, un intervallo esplicito from/to valido e completo ha la precedenza. Se l'endpoint accetta latest, il valore fornito deve comunque superare le convalide esistenti del formato e dell'endpoint, ma viene ignorato nella selezione dell'intervallo e non inviato a Similarweb; non viene aggiunto alcun latest predefinito. Senza un intervallo esplicito, il comportamento esistente di latest, valori predefiniti e finestre resta invariato. Restano valide le restrizioni di History; gli endpoint che non accettano latest continuano a rifiutarlo.

Senza un intervallo esplicito from/to: Le route basate su finestre usano normalmente 28 giorni con termine tre giorni UTC fa e accettano da latest=1d a 366d. Le route a mesi fissi usano i valori predefiniti indicati sotto. Interazioni, visite, classifiche e canali accettano anche latest=1m|2m|3m|6m per i mesi di calendario UTC completi precedenti; questi selettori richiedono isWindow=false e usano per impostazione predefinita timeGranularity=Monthly. Lo storico applica le regole più restrittive documentate per i suoi quattro endpoint.

Sono supportati solo dati mondiali (country=999). Gli identificatori dei siti sono domini come example.com, tranne nell'endpoint delle classifiche per parola chiave, dove keys è una parola chiave di ricerca. Disponibilità dei dati, filtri e tipi di corrispondenza del servizio a monte possono variare. Gli altri valori di paese validi vengono sostituiti con 999 prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.

Le risposte riuscite preservano il JSON nativo invece di adottare uno schema universale. Le tabelle dei referral in entrata e in uscita usano Records; le metriche storiche possono usare Data annidati. I nomi e le unità descritti sotto non implicano che ogni campo facoltativo del servizio a monte sia sempre presente.

Punti di accesso

Suggerimenti di parole chiave

GET https://api.apihop.ai/v1/similarweb/keywords/suggestions

Valori predefiniti: country 999, latest 28d, rowsPerPage 100, type Broad, websource Total e windowVolume decrescente. Il parametro facoltativo page parte da 1. rangeFilter usa la sintassi nativa, per esempio volume,100,10000|difficulty,0,40. La disponibilità dei tipi di corrispondenza e dei filtri dipende dalla sorgente dei dati. Sono supportati solo dati mondiali (country=999).

Campo della query	Obbligatorio	Tipo e vincoli
`keyword`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sort`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`asc`	No	Stringa booleana: true o false
`page`	No	Stringa di un intero; 1-1000
`rowsPerPage`	No	Stringa di un intero; 1-1000
`type`	No	Stringa; valori ammessi: Broad, Phrase, Exact, Related
`websource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`isWindow`	No	Stringa booleana: true o false
`rangeFilter`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Collegamenti in entrata

GET https://api.apihop.ai/v1/similarweb/websites/backlinks

Valori predefiniti: Page 1, PageSize 100, Status All, FollowType All e DomainScore decrescente. Key ha l'iniziale maiuscola; non usare key o keys.

Campo della query	Obbligatorio	Tipo e vincoli
`Key`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`Page`	No	Stringa di un intero; 1-1000
`PageSize`	No	Stringa di un intero; 1-1000
`Status`	No	Stringa; valori ammessi: All, Active, New, Lost
`FollowType`	No	Stringa; valori ammessi: All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow
`DomainScoreFrom`	No	Stringa di un intero; 0-100
`DomainScoreTo`	No	Stringa di un intero; 0-100
`sort`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`asc`	No	Stringa booleana: true o false

Parole chiave del sito

GET https://api.apihop.ai/v1/similarweb/websites/keywords

Valori predefiniti: page 1, pageSize 100, sourceType all ed entrambi i flag del marchio false. pageFilterJson è una singola stringa di array JSON codificata come URL; se omessa, usa keys come dominio. Senza un intervallo esplicito from/to: latest=1m seleziona la panoramica di un mese con pageSize 5 e isWindow=false, salvo indicazione esplicita. Usa sourceType=organic o paid con IncludeNoneBranded=true e IncludeBranded=false per le viste delle parole chiave senza marchio.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sort`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`asc`	No	Stringa booleana: true o false
`iso`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`isDaily`	No	Stringa booleana: true o false
`IncludeBranded`	No	Stringa booleana: true o false
`IncludeNoneBranded`	No	Stringa booleana: true o false
`page`	No	Stringa di un intero; 1-1000
`pageSize`	No	Stringa di un intero; 1-1000
`sourceType`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`pageFilterJson`	No	Stringa contenente un array JSON

Siti posizionati per parola chiave

GET https://api.apihop.ai/v1/similarweb/keywords/websites

keys è una parola chiave, non un dominio web. I valori predefiniti includono selectedPageTab=Organic, sourceType=organic, Device=Total e graphDuration=28d. I parametri facoltativi page e pageSize usano rispettivamente interi a partire da 1 e interi positivi.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sort`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`asc`	No	Stringa booleana: true o false
`iso`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`isDaily`	No	Stringa booleana: true o false
`tab`	No	Stringa di un intero non negativo
`mtd`	No	Stringa booleana: true o false
`selectedPageTab`	No	Stringa; valori ammessi: Organic, Paid
`graphDuration`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`graphType`	No	Stringa di un intero; 1-1000
`isDurationChanged`	No	Stringa booleana: true o false
`ignoreFilterConsistency`	No	Stringa booleana: true o false
`Device`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sourceType`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`page`	No	Stringa di un intero; 1-1000
`pageSize`	No	Stringa di un intero; 1-1000

Sorgenti di traffico

GET https://api.apihop.ai/v1/similarweb/websites/traffic-sources

Valori predefiniti: sourceType=Referral, page=1, orderBy=Share desc e timeGranularity=Daily. Questa tabella è distinta dall'endpoint dei referral in entrata.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sourceType`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`ignoreFilterConsistency`	No	Stringa booleana: true o false
`page`	No	Stringa di un intero; 1-1000
`orderBy`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Traffico in uscita

GET https://api.apihop.ai/v1/similarweb/websites/outgoing-traffic

from e to sono obbligatori. Solo key singolare. Valori predefiniti: country=999, isWWW=false, isWindow=false, webSource=Total, page=1, orderby=Share desc, orderBy=Share desc, sort=Share, asc=false. orderby e orderBy sono distinti e inoltrati indipendentemente; mantienili coerenti. Non sono ammessi latest, pageSize, rowsPerPage, includeSubDomains o timeGranularity. Le righe sono in Records; TotalCount è il totale del servizio a monte, non la lunghezza della pagina corrente. Sono supportati solo dati mondiali (country=999).

Campo della query	Obbligatorio	Tipo e vincoli
`key`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	Sì	Stringa; data valida nei formati indicati sopra
`to`	Sì	Stringa; data valida nei formati indicati sopra
`isWWW`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`orderby`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`orderBy`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`sort`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`asc`	No	Stringa booleana: true o false
`page`	No	Stringa di un intero; 1-1000

Referral in entrata

GET https://api.apihop.ai/v1/similarweb/websites/incoming-referrals

Solo key singolare. Valori predefiniti: country=999, latest=28d, isWWW=false, isWindow=true, isDaily=false, webSource=Total, selectedTab=incomingTraffic, orderBy=TotalShare desc, ignoreFilterConsistency=false, page=1. Non sono ammessi keys, pageSize, rowsPerPage, includeSubDomains o timeGranularity. Le righe sono in Records; i campi nativi possono includere SiteOrigins e TotalShare. Sono supportati solo dati mondiali (country=999).

Campo della query	Obbligatorio	Tipo e vincoli
`key`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`isWWW`	No	Stringa booleana: true o false
`iso`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`isWindow`	No	Stringa booleana: true o false
`isDaily`	No	Stringa booleana: true o false
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`selectedTab`	No	Stringa; valori ammessi: incomingTraffic
`orderBy`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`ignoreFilterConsistency`	No	Stringa booleana: true o false
`page`	No	Stringa di un intero; 1-1000

GET https://api.apihop.ai/v1/similarweb/websites/branded-keywords

Il valore predefinito è il mese UTC completo precedente. duration è fissato a 1m.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`duration`	No	Stringa; valori ammessi: 1m

Distribuzione geografica del traffico

GET https://api.apihop.ai/v1/similarweb/websites/geography

I valori predefiniti sono i tre mesi UTC completi precedenti, pageSize=5 e orderBy=TotalShare desc.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`pageSize`	No	Stringa di un intero; 1-1000
`orderBy`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Distribuzione per dispositivo

GET https://api.apihop.ai/v1/similarweb/websites/devices

I valori predefiniti sono i tre mesi UTC completi precedenti e ShouldGetVerifiedData=false.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`ShouldGetVerifiedData`	No	Stringa booleana: true o false

Rendimento della ricerca

GET https://api.apihop.ai/v1/similarweb/websites/search-performance

I valori predefiniti sono il mese UTC completo precedente, pageSize=5, duration=1m e SourceType=Organic. Usa SourceType=Paid per le parole chiave a pagamento; non sostituirlo con sourceType.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`pageSize`	No	Stringa di un intero; 1-1000
`duration`	No	Stringa; valori ammessi: 1m
`SourceType`	No	Stringa; valori ammessi: Organic, Paid

GET https://api.apihop.ai/v1/similarweb/websites/social-traffic

Il valore predefinito sono i tre mesi UTC completi precedenti. webSource non è accettato.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Panoramica delle interazioni

GET https://api.apihop.ai/v1/similarweb/websites/engagement

I valori predefiniti includono ShouldGetVerifiedData=false, includeLeaders=true e unBounced=false. Le righe native Data possono contenere AvgMonthVisits, BounceRate, PagesPerVisit e AvgVisitDuration.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`ShouldGetVerifiedData`	No	Stringa booleana: true o false
`includeLeaders`	No	Stringa booleana: true o false
`unBounced`	No	Stringa booleana: true o false
`beta`	No	Stringa booleana: true o false

Visite totali

GET https://api.apihop.ai/v1/similarweb/websites/visits

compareFrom e compareTo devono essere forniti insieme come date valide e ordinate. timeGranularity è Monthly. I campi nativi possono includere TotalVisits, Change e ShareOfVisits; un totale mobile non corrisponde necessariamente a un mese di calendario completo.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`compareFrom`	No	Stringa; data valida nei formati indicati sopra
`compareTo`	No	Stringa; data valida nei formati indicati sopra
`ShouldGetVerifiedData`	No	Stringa booleana: true o false

Tabella delle visite

GET https://api.apihop.ai/v1/similarweb/websites/visits/table

compareFrom e compareTo devono essere forniti insieme come date valide e ordinate. timeGranularity è Monthly; le righe sono in Data, con Domain e TotalVisits. TotalCount può essere 0 anche quando Data contiene righe; controlla l'array stesso per determinare se sono presenti risultati.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`compareFrom`	No	Stringa; data valida nei formati indicati sopra
`compareTo`	No	Stringa; data valida nei formati indicati sopra
`ShouldGetVerifiedData`	No	Stringa booleana: true o false

Andamento delle visite

GET https://api.apihop.ai/v1/similarweb/websites/visits/trend

La finestra predefinita è mobile di 28 giorni con dati giornalieri. timeGranularity accetta Daily, Weekly o Monthly.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Weekly, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`ShouldGetVerifiedData`	No	Stringa booleana: true o false

Classifiche dei siti

GET https://api.apihop.ai/v1/similarweb/websites/ranks

timeGranularity è Monthly. La risposta nativa usa oggetti distinti GlobalRank, CountryRank e CategoryRank.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Classifiche nazionali

GET https://api.apihop.ai/v1/similarweb/websites/ranks/country

timeGranularity è Monthly. Questa è la tabella esplicita della classifica nazionale, non la risposta combinata delle classifiche. Le righe sono in Data, con Domain e Rank. TotalCount può essere 0 anche in presenza di righe; controlla direttamente Data.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Classifiche globali

GET https://api.apihop.ai/v1/similarweb/websites/ranks/global

timeGranularity è Monthly. Restituisce la tabella separata della classifica globale. Le righe sono in Data, con Domain e Rank. TotalCount può essere 0 anche in presenza di righe; controlla direttamente Data.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Classifiche per categoria

GET https://api.apihop.ai/v1/similarweb/websites/ranks/category

timeGranularity è Monthly. Restituisce la tabella separata della classifica per settore/categoria. Le righe sono in Data, con Domain e Rank. TotalCount può essere 0 anche in presenza di righe; controlla direttamente Data.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Canali di traffico

GET https://api.apihop.ai/v1/similarweb/websites/channels

La finestra predefinita è mobile di 28 giorni con dati giornalieri. Con webSource=Total, i valori dei canali si trovano sotto Data.Total[domain], non direttamente sotto Data[domain]. I nomi dei canali, per esempio Search - Organic e Direct, vengono preservati. I valori sono conteggi delle visite; ricava le quote solo quando la loro somma è positiva.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Daily, Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Siti simili

GET https://api.apihop.ai/v1/similarweb/websites/similar-sites

Il valore predefinito sono i tre mesi UTC completi precedenti. isWindow deve essere false, timeGranularity è Monthly e orderBy è fissato a Affinity desc. Non sono ammessi latest o webSource.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`orderBy`	No	Stringa; valori ammessi: Affinity desc

Suggerimenti di siti simili

GET https://api.apihop.ai/v1/similarweb/websites/similar-sites/suggestions

key singolare; limit è 20 per impostazione predefinita e deve essere 1-20. country è 999 per impostazione predefinita e webSource è Total. La risposta nativa osservata è un array non incapsulato di candidati con Domain, DomainWithoutSub, Rank numerico e Favicon; non aspettarti un contenitore Data. Un array vuoto non contiene suggerimenti. Sono supportati solo dati mondiali (country=999).

Campo della query	Obbligatorio	Tipo e vincoli
`key`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`limit`	No	Stringa di un intero; 1-20
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb

Storico mensile delle visite

GET https://api.apihop.ai/v1/similarweb/websites/history/visits

Per impostazione predefinita vengono usati i sei mesi UTC completi precedenti. Sono supportati solo country=999, isWindow=false e timeGranularity=Monthly. latest accetta da 1m a 6m; le date esplicite devono coprire mesi completi all'interno di questa finestra mobile di sei mesi. Le serie native possono comparire sotto Data.<domain>.<source> con punti Key/Value; i nomi delle sorgenti, inclusi MobileWeb o Mobile Web, vengono preservati. I valori rappresentano visite stimate.

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Storico mensile della frequenza di rimbalzo

GET https://api.apihop.ai/v1/similarweb/websites/history/bounce-rate

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Storico mensile della durata delle visite

GET https://api.apihop.ai/v1/similarweb/websites/history/visit-duration

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni

Storico mensile delle pagine per visita

GET https://api.apihop.ai/v1/similarweb/websites/history/pages-per-visit

Campo della query	Obbligatorio	Tipo e vincoli
`keys`	Sì	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni
`country`	No	Stringa di un intero non negativo; Sono supportati solo dati mondiali (`country=999`). Gli altri valori di paese validi vengono sostituiti con `999` prima della richiesta al fornitore e restituiscono dati mondiali, non del paese indicato.
`from`	No	Stringa; data valida nei formati indicati sopra
`to`	No	Stringa; data valida nei formati indicati sopra
`includeSubDomains`	No	Stringa booleana: true o false
`isWindow`	No	Stringa booleana: true o false
`webSource`	No	Stringa; valori ammessi: Total, Desktop, MobileWeb
`timeGranularity`	No	Stringa; valori ammessi: Monthly
`latest`	No	Stringa; 1-2048 byte UTF-8 dopo la rimozione degli spazi esterni