Similarweb API 參考 | 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`

下列所有路徑皆相對於您的 API 來源網址。每個請求都需要 Authorization: Bearer YOUR_API_KEY，使用 GET，且不含請求主體。請參閱驗證、計費與錯誤。

查詢規則

單一網站欄位 key 和 Key 需要一個 ASCII 網域，例如 amazon.com，最多 253 個字元，前後不得有空白。請勿在這些欄位中傳送 URL、IP 位址、網域清單或 API 憑證。國際化網域請使用 punycode。

查詢名稱區分大小寫。未知欄位、重複欄位、CR/LF/NUL 和無效值會被拒絕。布林值必須是字面值 true 或 false；零不能代替 false。文字去除前後空白後，長度須為 1-2048 個 UTF-8 位元組。請使用 HTTP 用戶端的查詢編碼器編碼空白、JSON 陣列和分隔符號。

from 和 to 必須同時出現，是格式為 YYYY-MM-DD 或 YYYY|MM|DD 的實際日曆日期，且符合 from <= to。比較日期配對也遵循相同規則。選填欄位沿用端點預設值；表格列出允許的欄位，並不要求全部傳送。

對於接受日期的端點，合法、完整的明確 from/to 區間優先。對於接受 latest 的端點，傳入的值仍須通過原有格式和端點允許值驗證，但不再用於選擇區間，也不傳給 Similarweb；不補預設 latest。沒有明確區間時，原有 latest、預設值和視窗行為保持不變。History 的限制仍適用；不接受 latest 的端點仍拒絕該欄位。

未提供明確 from/to 區間時：以時間區間為基礎的路由通常預設為截至三個 UTC 日前的 28 天，接受 latest=1d 至 366d。固定月份路由的預設值如下所示。互動、造訪、排名及管道另接受 latest=1m|2m|3m|6m，代表先前完整的 UTC 日曆月份；這些選擇器要求 isWindow=false，並預設為 timeGranularity=Monthly。歷史資料的四個端點適用各自文件中較嚴格的規則。

僅支援全球資料（country=999）。網站識別碼是 example.com 這類網域，但關鍵字排名端點的 keys 是搜尋關鍵字。上游資料可用性、篩選器和比對類型可能有所不同。其他合法的國家參數值在請求上游前統一改為 999，傳回全球資料，而非所指定國家的資料。

成功回應保留原生 JSON，而不採用統一的回應結構。流入與流出推薦表格使用 Records；歷史指標可能使用巢狀 Data。以下名稱和單位不代表每個上游選填欄位都一定存在。

端點

關鍵字建議

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

預設值：country 999、latest 28d、rowsPerPage 100、type Broad、websource Total，以及 windowVolume 遞減排序。選填的 page 從 1 開始。rangeFilter 使用原生語法，例如 volume,100,10000|difficulty,0,40。比對類型與篩選器的可用性取決於資料來源。僅支援全球資料（country=999）。

查詢欄位	必填	類型與限制
`keyword`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sort`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`asc`	否	布林字串：true 或 false
`page`	否	整數字串；1-1000
`rowsPerPage`	否	整數字串；1-1000
`type`	否	字串；列舉值：Broad, Phrase, Exact, Related
`websource`	否	字串；列舉值：Total, Desktop, MobileWeb
`isWindow`	否	布林字串：true 或 false
`rangeFilter`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

反向連結

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

預設值：Page 1、PageSize 100、Status All、FollowType All，以及 DomainScore 遞減排序。Key 的首字母為大寫；請勿使用 key 或 keys。

查詢欄位	必填	類型與限制
`Key`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`Page`	否	整數字串；1-1000
`PageSize`	否	整數字串；1-1000
`Status`	否	字串；列舉值：All, Active, New, Lost
`FollowType`	否	字串；列舉值：All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow
`DomainScoreFrom`	否	整數字串；0-100
`DomainScoreTo`	否	整數字串；0-100
`sort`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`asc`	否	布林字串：true 或 false

網站關鍵字

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

預設值：page 1、pageSize 100、sourceType all，且兩個品牌旗標皆為 false。pageFilterJson 是單一經 URL 編碼的 JSON 陣列字串；省略時會將 keys 視為網域。未提供明確 from/to 區間時：latest=1m 選擇單月總覽模式，除非明確指定，否則 pageSize 為 5 且 isWindow=false。非品牌關鍵字檢視請使用 sourceType=organic 或 paid，搭配 IncludeNoneBranded=true 和 IncludeBranded=false。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sort`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`asc`	否	布林字串：true 或 false
`iso`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`isDaily`	否	布林字串：true 或 false
`IncludeBranded`	否	布林字串：true 或 false
`IncludeNoneBranded`	否	布林字串：true 或 false
`page`	否	整數字串；1-1000
`pageSize`	否	整數字串；1-1000
`sourceType`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`pageFilterJson`	否	包含 JSON 陣列的字串

關鍵字排名網站

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

keys 是關鍵字，而非網站網域。預設值包括 selectedPageTab=Organic、sourceType=organic、Device=Total 和 graphDuration=28d。選填的 page 從 1 開始，pageSize 使用正整數。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sort`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`asc`	否	布林字串：true 或 false
`iso`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`isDaily`	否	布林字串：true 或 false
`tab`	否	非負整數字串
`mtd`	否	布林字串：true 或 false
`selectedPageTab`	否	字串；列舉值：Organic, Paid
`graphDuration`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`graphType`	否	整數字串；1-1000
`isDurationChanged`	否	布林字串：true 或 false
`ignoreFilterConsistency`	否	布林字串：true 或 false
`Device`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sourceType`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`page`	否	整數字串；1-1000
`pageSize`	否	整數字串；1-1000

流量來源

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

預設值：sourceType=Referral、page=1、orderBy=Share desc 和 timeGranularity=Daily。此表格與流入推薦端點不同。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sourceType`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`ignoreFilterConsistency`	否	布林字串：true 或 false
`page`	否	整數字串；1-1000
`orderBy`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

流出流量

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

from 和 to 為必填。僅使用單數 key。預設值：country=999、isWWW=false、isWindow=false、webSource=Total、page=1、orderby=Share desc、orderBy=Share desc、sort=Share、asc=false。orderby 和 orderBy 是不同欄位，會各自轉送，請保持一致。不接受 latest、pageSize、rowsPerPage、includeSubDomains 或 timeGranularity。資料列位於 Records；TotalCount 是上游總數，而非目前頁面的長度。僅支援全球資料（country=999）。

查詢欄位	必填	類型與限制
`key`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	是	字串；使用上述格式的有效日期
`to`	是	字串；使用上述格式的有效日期
`isWWW`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`orderby`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`orderBy`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`sort`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`asc`	否	布林字串：true 或 false
`page`	否	整數字串；1-1000

流入推薦

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

僅使用單數 key。預設值：country=999、latest=28d、isWWW=false、isWindow=true、isDaily=false、webSource=Total、selectedTab=incomingTraffic、orderBy=TotalShare desc、ignoreFilterConsistency=false、page=1。不接受 keys、pageSize、rowsPerPage、includeSubDomains 或 timeGranularity。資料列位於 Records；原生欄位可能包含 SiteOrigins 和 TotalShare。僅支援全球資料（country=999）。

查詢欄位	必填	類型與限制
`key`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`isWWW`	否	布林字串：true 或 false
`iso`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`isWindow`	否	布林字串：true 或 false
`isDaily`	否	布林字串：true 或 false
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`selectedTab`	否	字串；列舉值：incomingTraffic
`orderBy`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`ignoreFilterConsistency`	否	布林字串：true 或 false
`page`	否	整數字串；1-1000

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

預設為前一個完整的 UTC 月份。duration 固定為 1m。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`duration`	否	字串；列舉值：1m

流量地理分布

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

預設為前三個完整的 UTC 月份，pageSize=5 且 orderBy=TotalShare desc。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`pageSize`	否	整數字串；1-1000
`orderBy`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

裝置分布

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

預設為前三個完整的 UTC 月份，且 ShouldGetVerifiedData=false。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`ShouldGetVerifiedData`	否	布林字串：true 或 false

搜尋成效

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

預設為前一個完整的 UTC 月份，pageSize=5、duration=1m 且 SourceType=Organic。付費關鍵字請使用 SourceType=Paid；請勿以 sourceType 取代。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`pageSize`	否	整數字串；1-1000
`duration`	否	字串；列舉值：1m
`SourceType`	否	字串；列舉值：Organic, Paid

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

預設為前三個完整的 UTC 月份。不接受 webSource。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

互動總覽

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

預設值包括 ShouldGetVerifiedData=false、includeLeaders=true 和 unBounced=false。原生 Data 資料列可能包含 AvgMonthVisits、BounceRate、PagesPerVisit 和 AvgVisitDuration。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`ShouldGetVerifiedData`	否	布林字串：true 或 false
`includeLeaders`	否	布林字串：true 或 false
`unBounced`	否	布林字串：true 或 false
`beta`	否	布林字串：true 或 false

總造訪次數

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

compareFrom 和 compareTo 必須一同提供，且為順序正確的有效日期。timeGranularity 為 Monthly。原生欄位可能包含 TotalVisits、Change 和 ShareOfVisits；滾動總數不一定等於完整日曆月的總數。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`compareFrom`	否	字串；使用上述格式的有效日期
`compareTo`	否	字串；使用上述格式的有效日期
`ShouldGetVerifiedData`	否	布林字串：true 或 false

造訪表格

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

compareFrom 和 compareTo 必須一同提供，且為順序正確的有效日期。timeGranularity 為 Monthly；資料列位於 Data，包含 Domain 和 TotalVisits。即使 Data 含有資料列，TotalCount 仍可能為 0；請檢查陣列本身以判斷是否有結果。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`compareFrom`	否	字串；使用上述格式的有效日期
`compareTo`	否	字串；使用上述格式的有效日期
`ShouldGetVerifiedData`	否	布林字串：true 或 false

造訪趨勢

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

預設為按日統計的滾動 28 天區間。timeGranularity 接受 Daily、Weekly 或 Monthly。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Weekly, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`ShouldGetVerifiedData`	否	布林字串：true 或 false

網站排名

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

timeGranularity 為 Monthly。原生回應使用各自獨立的 GlobalRank、CountryRank 和 CategoryRank 物件。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

國家排名

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

timeGranularity 為 Monthly。這是明確的國家排名表格，而非合併的排名回應。資料列位於 Data，包含 Domain 和 Rank。即使有資料列，TotalCount 仍可能為 0；請直接檢查 Data。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

全球排名

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

timeGranularity 為 Monthly。此端點回傳獨立的全球排名表格。資料列位於 Data，包含 Domain 和 Rank。即使有資料列，TotalCount 仍可能為 0；請直接檢查 Data。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

分類排名

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

timeGranularity 為 Monthly。此端點回傳獨立的產業／分類排名表格。資料列位於 Data，包含 Domain 和 Rank。即使有資料列，TotalCount 仍可能為 0；請直接檢查 Data。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

流量管道

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

預設為按日統計的滾動 28 天區間。當 webSource=Total 時，管道值位於 Data.Total[domain] 下，而非直接位於 Data[domain] 下。管道名稱會保留，例如 Search - Organic 和 Direct。數值代表造訪次數；僅在總和為正時推算占比。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Daily, Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

相似網站

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

預設為前三個完整的 UTC 月份。isWindow 必須為 false，timeGranularity 為 Monthly，orderBy 固定為 Affinity desc。不接受 latest 或 webSource。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`timeGranularity`	否	字串；列舉值：Monthly
`orderBy`	否	字串；列舉值：Affinity desc

相似網站建議

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

使用單數 key；limit 預設為 20，且必須為 1-20。country 預設為 999，webSource 預設為 Total。觀察到的原生回應是未包裝的候選陣列，包含 Domain、DomainWithoutSub、數值型 Rank 和 Favicon；請勿預期有 Data 外層。空陣列表示沒有建議。僅支援全球資料（country=999）。

查詢欄位	必填	類型與限制
`key`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`limit`	否	整數字串；1-20
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb

每月造訪歷史

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

預設為前六個完整的 UTC 月份。僅支援 country=999、isWindow=false 和 timeGranularity=Monthly。latest 接受 1m 至 6m；明確指定的日期必須涵蓋此滾動六個月區間內的完整月份。原生序列可能位於 Data.<domain>.<source> 下，包含 Key/Value 資料點；來源名稱（包括 MobileWeb 或 Mobile Web）會保留。數值代表估計造訪次數。

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

每月跳出率歷史

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

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

每月造訪時間歷史

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

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組

每月每次造訪頁數歷史

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

查詢欄位	必填	類型與限制
`keys`	是	字串；去除前後空白後為 1-2048 個 UTF-8 位元組
`country`	否	非負整數字串; 僅支援全球資料（`country=999`）。其他合法的國家參數值在請求上游前統一改為 `999`，傳回全球資料，而非所指定國家的資料。
`from`	否	字串；使用上述格式的有效日期
`to`	否	字串；使用上述格式的有效日期
`includeSubDomains`	否	布林字串：true 或 false
`isWindow`	否	布林字串：true 或 false
`webSource`	否	字串；列舉值：Total, Desktop, MobileWeb
`timeGranularity`	否	字串；列舉值：Monthly
`latest`	否	字串；去除前後空白後為 1-2048 個 UTF-8 位元組