Similarweb API-Referenz | API-Dokumentation

# 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`

Alle folgenden Pfade sind relativ zu Ihrem API-Ursprung. Jede Anfrage erfordert Authorization: Bearer YOUR_API_KEY, verwendet GET und hat keinen Anfragekörper. Siehe Authentifizierung, Abrechnung und Fehler.

Abfrageregeln

Die einzelnen Website-Felder key und Key erfordern genau eine ASCII-Domain wie amazon.com mit höchstens 253 Zeichen und ohne umgebende Leerzeichen. Senden Sie in diesen Feldern keine URL, IP-Adresse, Domainliste oder API-Zugangsdaten. Verwenden Sie für internationalisierte Domains Punycode.

Parameternamen unterscheiden Groß- und Kleinschreibung. Unbekannte oder doppelte Felder, CR/LF/NUL und ungültige Werte werden abgelehnt. Boolesche Werte sind die Literale true oder false; null ist nicht mit false austauschbar. Text umfasst nach dem Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes. Kodieren Sie Leerzeichen, JSON-Arrays und Trennzeichen mit dem Abfrage-Encoder Ihres HTTP-Clients.

from und to müssen gemeinsam vorkommen, gültige Kalenderdaten im Format YYYY-MM-DD oder YYYY|MM|DD sein und from <= to erfüllen. Für ein Vergleichspaar gilt dieselbe Regel. Optionale Felder übernehmen die Standardwerte des Endpunkts; die Tabellen nennen zulässige Felder und verlangen nicht, dass Sie alle senden.

Bei Endpunkten mit Datumsparametern hat ein gültiger, vollständiger expliziter from/to-Zeitraum Vorrang. Akzeptiert der Endpunkt latest, muss ein angegebener Wert weiterhin die bestehende Format- und endpunktspezifische Validierung bestehen, wird aber bei der Zeitraumwahl ignoriert und nicht an Similarweb gesendet; ein Standardwert für latest wird nicht ergänzt. Ohne expliziten Zeitraum bleiben das bisherige latest-, Standardwert- und Fensterverhalten unverändert. Die History-Einschränkungen gelten weiterhin; Endpunkte ohne latest lehnen dieses Feld weiterhin ab.

Ohne expliziten from/to-Zeitraum: Fensterbasierte Routen verwenden normalerweise ein 28-Tage-Fenster, das vor drei UTC-Tagen endet, und akzeptieren latest=1d bis 366d. Routen mit festen Monaten verwenden die unten angegebenen Standardwerte. Interaktion, Besuche, Rankings und Kanäle akzeptieren zusätzlich latest=1m|2m|3m|6m für vorherige vollständige UTC-Kalendermonate; diese Selektoren erfordern isWindow=false und verwenden standardmäßig timeGranularity=Monthly. Für Verlaufsdaten gelten die engeren Regeln der vier entsprechenden Endpunkte.

Es werden nur weltweite Daten unterstützt (country=999). Website-Kennungen sind Domains wie example.com, außer beim Keyword-Ranking-Endpunkt, wo keys ein Suchbegriff ist. Datenverfügbarkeit, Filter und Übereinstimmungstypen des vorgelagerten Dienstes können variieren. Andere gültige Länderwerte werden vor der Upstream-Anfrage in 999 geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.

Erfolgreiche Antworten behalten natives JSON bei, statt ein universelles Antwortschema zu verwenden. Tabellen für eingehende und ausgehende Verweise verwenden Records; historische Kennzahlen können verschachtelte Data verwenden. Die folgenden Namen und Einheiten bedeuten nicht, dass jedes optionale Feld des vorgelagerten Dienstes immer vorhanden ist.

API-Endpunkte

Keyword-Vorschläge

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

Standardwerte: country 999, latest 28d, rowsPerPage 100, type Broad, websource Total und windowVolume absteigend. Das optionale page beginnt bei 1. rangeFilter verwendet native Syntax, zum Beispiel volume,100,10000|difficulty,0,40. Die Verfügbarkeit von Übereinstimmungstypen und Filtern hängt von der Datenquelle ab. Es werden nur weltweite Daten unterstützt (country=999).

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keyword`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sort`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`asc`	Nein	Boolesche Zeichenfolge: true oder false
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`rowsPerPage`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`type`	Nein	Zeichenfolge; Aufzählung: Broad, Phrase, Exact, Related
`websource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`rangeFilter`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Rückverweise

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

Standardwerte: Page 1, PageSize 100, Status All, FollowType All und DomainScore absteigend. Key wird großgeschrieben; verwenden Sie weder key noch keys.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`Key`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`Page`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`PageSize`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`Status`	Nein	Zeichenfolge; Aufzählung: All, Active, New, Lost
`FollowType`	Nein	Zeichenfolge; Aufzählung: All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow
`DomainScoreFrom`	Nein	Ganzzahl als Zeichenfolge; 0-100
`DomainScoreTo`	Nein	Ganzzahl als Zeichenfolge; 0-100
`sort`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`asc`	Nein	Boolesche Zeichenfolge: true oder false

Website-Keywords

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

Standardwerte: page 1, pageSize 100, sourceType all und beide Marken-Flags false. pageFilterJson ist eine URL-kodierte JSON-Array-Zeichenfolge; ohne dieses Feld wird keys als Domain verwendet. Ohne expliziten from/to-Zeitraum: latest=1m wählt den einmonatigen Übersichtsmodus mit pageSize 5 und isWindow=false, sofern nicht ausdrücklich anders angegeben. Verwenden Sie sourceType=organic oder paid mit IncludeNoneBranded=true und IncludeBranded=false für Ansichten nicht markenbezogener Keywords.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sort`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`asc`	Nein	Boolesche Zeichenfolge: true oder false
`iso`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`isDaily`	Nein	Boolesche Zeichenfolge: true oder false
`IncludeBranded`	Nein	Boolesche Zeichenfolge: true oder false
`IncludeNoneBranded`	Nein	Boolesche Zeichenfolge: true oder false
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`pageSize`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`sourceType`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`pageFilterJson`	Nein	Zeichenfolge mit einem JSON-Array

Für Keywords platzierte Websites

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

keys ist ein Keyword, keine Website-Domain. Zu den Standardwerten gehören selectedPageTab=Organic, sourceType=organic, Device=Total und graphDuration=28d. Die optionalen Felder page und pageSize verwenden bei 1 beginnende beziehungsweise positive Ganzzahlen.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sort`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`asc`	Nein	Boolesche Zeichenfolge: true oder false
`iso`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`isDaily`	Nein	Boolesche Zeichenfolge: true oder false
`tab`	Nein	Nichtnegative Ganzzahl als Zeichenfolge
`mtd`	Nein	Boolesche Zeichenfolge: true oder false
`selectedPageTab`	Nein	Zeichenfolge; Aufzählung: Organic, Paid
`graphDuration`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`graphType`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`isDurationChanged`	Nein	Boolesche Zeichenfolge: true oder false
`ignoreFilterConsistency`	Nein	Boolesche Zeichenfolge: true oder false
`Device`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sourceType`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`pageSize`	Nein	Ganzzahl als Zeichenfolge; 1-1000

Traffic-Quellen

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

Standardwerte: sourceType=Referral, page=1, orderBy=Share desc und timeGranularity=Daily. Diese Tabelle unterscheidet sich vom Endpunkt für eingehende Verweise.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sourceType`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`ignoreFilterConsistency`	Nein	Boolesche Zeichenfolge: true oder false
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`orderBy`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Ausgehender Traffic

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

from und to sind erforderlich. Nur das einzelne key wird akzeptiert. Standardwerte: country=999, isWWW=false, isWindow=false, webSource=Total, page=1, orderby=Share desc, orderBy=Share desc, sort=Share, asc=false. orderby und orderBy sind unterschiedliche Felder und werden unabhängig weitergereicht; halten Sie sie konsistent. Keine Unterstützung für latest, pageSize, rowsPerPage, includeSubDomains oder timeGranularity. Zeilen stehen in Records; TotalCount ist die Gesamtzahl des vorgelagerten Dienstes, nicht die Länge der aktuellen Seite. Es werden nur weltweite Daten unterstützt (country=999).

Abfragefeld	Erforderlich	Typ und Einschränkungen
`key`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Ja	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Ja	Zeichenfolge; gültiges Datum in einem der obigen Formate
`isWWW`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`orderby`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`orderBy`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`sort`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`asc`	Nein	Boolesche Zeichenfolge: true oder false
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000

Eingehende Verweise

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

Nur das einzelne key wird akzeptiert. Standardwerte: country=999, latest=28d, isWWW=false, isWindow=true, isDaily=false, webSource=Total, selectedTab=incomingTraffic, orderBy=TotalShare desc, ignoreFilterConsistency=false, page=1. Keine Unterstützung für keys, pageSize, rowsPerPage, includeSubDomains oder timeGranularity. Zeilen stehen in Records; native Felder können SiteOrigins und TotalShare enthalten. Es werden nur weltweite Daten unterstützt (country=999).

Abfragefeld	Erforderlich	Typ und Einschränkungen
`key`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`isWWW`	Nein	Boolesche Zeichenfolge: true oder false
`iso`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`isDaily`	Nein	Boolesche Zeichenfolge: true oder false
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`selectedTab`	Nein	Zeichenfolge; Aufzählung: incomingTraffic
`orderBy`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`ignoreFilterConsistency`	Nein	Boolesche Zeichenfolge: true oder false
`page`	Nein	Ganzzahl als Zeichenfolge; 1-1000

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

Standardmäßig wird der vorherige vollständige UTC-Monat verwendet. duration ist auf 1m festgelegt.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`duration`	Nein	Zeichenfolge; Aufzählung: 1m

Geografische Traffic-Verteilung

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

Standardmäßig werden die vorherigen drei vollständigen UTC-Monate mit pageSize=5 und orderBy=TotalShare desc verwendet.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`pageSize`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`orderBy`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Geräteverteilung

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

Standardmäßig werden die vorherigen drei vollständigen UTC-Monate und ShouldGetVerifiedData=false verwendet.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`ShouldGetVerifiedData`	Nein	Boolesche Zeichenfolge: true oder false

Suchleistung

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

Standardmäßig werden der vorherige vollständige UTC-Monat, pageSize=5, duration=1m und SourceType=Organic verwendet. Verwenden Sie SourceType=Paid für bezahlte Keywords; ersetzen Sie es nicht durch sourceType.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`pageSize`	Nein	Ganzzahl als Zeichenfolge; 1-1000
`duration`	Nein	Zeichenfolge; Aufzählung: 1m
`SourceType`	Nein	Zeichenfolge; Aufzählung: Organic, Paid

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

Standardmäßig werden die vorherigen drei vollständigen UTC-Monate verwendet. webSource wird nicht akzeptiert.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Interaktionsübersicht

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

Zu den Standardwerten gehören ShouldGetVerifiedData=false, includeLeaders=true und unBounced=false. Native Data-Zeilen können AvgMonthVisits, BounceRate, PagesPerVisit und AvgVisitDuration enthalten.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`ShouldGetVerifiedData`	Nein	Boolesche Zeichenfolge: true oder false
`includeLeaders`	Nein	Boolesche Zeichenfolge: true oder false
`unBounced`	Nein	Boolesche Zeichenfolge: true oder false
`beta`	Nein	Boolesche Zeichenfolge: true oder false

Besuche insgesamt

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

compareFrom und compareTo müssen gemeinsam als gültige, chronologisch geordnete Daten angegeben werden. timeGranularity ist Monthly. Native Felder können TotalVisits, Change und ShareOfVisits enthalten; eine rollierende Gesamtsumme entspricht nicht zwingend der Summe eines vollständigen Kalendermonats.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`compareFrom`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`compareTo`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`ShouldGetVerifiedData`	Nein	Boolesche Zeichenfolge: true oder false

Besuchstabelle

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

compareFrom und compareTo müssen gemeinsam als gültige, chronologisch geordnete Daten angegeben werden. timeGranularity ist Monthly; Zeilen stehen in Data mit Domain und TotalVisits. TotalCount kann 0 sein, obwohl Data Zeilen enthält; prüfen Sie das Array selbst, um festzustellen, ob Ergebnisse vorhanden sind.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`compareFrom`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`compareTo`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`ShouldGetVerifiedData`	Nein	Boolesche Zeichenfolge: true oder false

Besuchstrend

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

Standardmäßig wird das rollierende 28-Tage-Fenster mit Tageswerten verwendet. timeGranularity akzeptiert Daily, Weekly oder Monthly.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Weekly, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`ShouldGetVerifiedData`	Nein	Boolesche Zeichenfolge: true oder false

Website-Rankings

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

timeGranularity ist Monthly. Die native Antwort verwendet separate Objekte für GlobalRank, CountryRank und CategoryRank.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Länder-Rankings

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

timeGranularity ist Monthly. Dies ist die ausdrückliche Länder-Ranking-Tabelle, nicht die kombinierte Ranking-Antwort. Zeilen stehen in Data mit Domain und Rank. TotalCount kann auch bei vorhandenen Zeilen 0 sein; prüfen Sie Data direkt.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Globale Rankings

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

timeGranularity ist Monthly. Dies liefert die separate globale Ranking-Tabelle. Zeilen stehen in Data mit Domain und Rank. TotalCount kann auch bei vorhandenen Zeilen 0 sein; prüfen Sie Data direkt.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Kategorie-Rankings

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

timeGranularity ist Monthly. Dies liefert die separate Branchen-/Kategorie-Ranking-Tabelle. Zeilen stehen in Data mit Domain und Rank. TotalCount kann auch bei vorhandenen Zeilen 0 sein; prüfen Sie Data direkt.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Traffic-Kanäle

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

Standardmäßig wird das rollierende 28-Tage-Fenster mit Tageswerten verwendet. Bei webSource=Total stehen Kanalwerte unter Data.Total[domain], nicht direkt unter Data[domain]. Kanalnamen wie Search - Organic und Direct bleiben erhalten. Die Werte sind Besuchszahlen; berechnen Sie Anteile nur bei einer positiven Summe.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Daily, Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Vorschläge ähnlicher Websites

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

Einzelnes key; limit beträgt standardmäßig 20 und muss zwischen 1-20 liegen. country ist standardmäßig 999 und webSource Total. Die beobachtete native Antwort ist ein nicht umschlossenes Kandidaten-Array mit Domain, DomainWithoutSub, numerischem Rank und Favicon; erwarten Sie keine Data-Hülle. Ein leeres Array enthält keine Vorschläge. Es werden nur weltweite Daten unterstützt (country=999).

Abfragefeld	Erforderlich	Typ und Einschränkungen
`key`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`limit`	Nein	Ganzzahl als Zeichenfolge; 1-20
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb

Monatlicher Besuchsverlauf

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

Standardmäßig werden die letzten sechs vollständigen UTC-Monate verwendet. Unterstützt werden nur country=999, isWindow=false und timeGranularity=Monthly. latest akzeptiert 1m bis 6m; explizite Datumsangaben müssen vollständige Monate innerhalb dieses rollierenden Sechsmonatsfensters abdecken. Native Reihen können unter Data.<domain>.<source> mit Key/Value-Punkten erscheinen; Quellnamen wie MobileWeb oder Mobile Web bleiben erhalten. Die Werte stellen geschätzte Besuche dar.

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Monatlicher Verlauf der Absprungrate

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

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Monatlicher Verlauf der Besuchsdauer

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

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes

Monatlicher Verlauf der Seiten pro Besuch

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

Abfragefeld	Erforderlich	Typ und Einschränkungen
`keys`	Ja	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes
`country`	Nein	Nichtnegative Ganzzahl als Zeichenfolge; Es werden nur weltweite Daten unterstützt (`country=999`). Andere gültige Länderwerte werden vor der Upstream-Anfrage in `999` geändert; zurückgegeben werden weltweite Daten, keine Daten des angegebenen Landes.
`from`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`to`	Nein	Zeichenfolge; gültiges Datum in einem der obigen Formate
`includeSubDomains`	Nein	Boolesche Zeichenfolge: true oder false
`isWindow`	Nein	Boolesche Zeichenfolge: true oder false
`webSource`	Nein	Zeichenfolge; Aufzählung: Total, Desktop, MobileWeb
`timeGranularity`	Nein	Zeichenfolge; Aufzählung: Monthly
`latest`	Nein	Zeichenfolge; nach Entfernen äußerer Leerzeichen 1-2048 UTF-8-Bytes