Similarweb API başvurusu | API Belgeleri

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

Aşağıdaki tüm yollar API kökünüze göredir. Her istek Authorization: Bearer YOUR_API_KEY gerektirir, GET kullanır ve istek gövdesi içermez. Kimlik doğrulama, faturalandırma ve hatalar bölümüne bakın.

Sorgu kuralları

Tekil web sitesi alanları key ve Key, amazon.com gibi en fazla 253 karakterli, başında veya sonunda boşluk bulunmayan tek bir ASCII alan adı gerektirir. Bu alanlarda URL, IP adresi, alan adı listesi veya API kimlik bilgisi göndermeyin. Uluslararası alan adları için punycode kullanın.

Sorgu adları büyük/küçük harfe duyarlıdır. Bilinmeyen alanlar, yinelenen alanlar, CR/LF/NUL ve geçersiz değerler reddedilir. Boolean değerleri doğrudan true veya false olmalıdır; sıfır, false yerine kullanılamaz. Metin, kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt uzunluğundadır. Boşlukları, JSON dizilerini ve ayırıcıları HTTP istemcinizin sorgu kodlayıcısıyla kodlayın.

from ve to birlikte bulunmalı, YYYY-MM-DD veya YYYY|MM|DD biçiminde gerçek takvim tarihleri olmalı ve from <= to koşulunu sağlamalıdır. Karşılaştırma çifti de aynı kurala uyar. İsteğe bağlı alanlar uç noktanın varsayılanlarını devralır; tablolar tüm alanların gönderilmesini değil, izin verilen alanları belirtir.

Tarih kabul eden uç noktalarda geçerli ve eksiksiz açık bir from/to aralığı önceliklidir. Uç nokta latest kabul ediyorsa gönderilen değer mevcut biçim ve uç noktaya özgü doğrulamalardan yine geçmelidir; ancak aralık seçiminde yok sayılır ve Similarweb'e gönderilmez, varsayılan latest de eklenmez. Açık bir aralık yoksa mevcut latest, varsayılan değer ve pencere davranışı değişmez. History kısıtlamaları geçerliliğini korur; latest kabul etmeyen uç noktalar bu alanı reddetmeye devam eder.

Açık bir from/to aralığı yoksa: Pencere tabanlı yollar normalde üç UTC gün önce biten 28 günlük bir pencere kullanır ve latest=1d ile 366d arasını kabul eder. Sabit aylı yollar aşağıda belirtilen varsayılanlara sahiptir. Etkileşim, ziyaret, sıralama ve kanal uç noktaları önceki tam UTC takvim ayları için ayrıca latest=1m|2m|3m|6m kabul eder; bu seçiciler isWindow=false gerektirir ve varsayılan olarak timeGranularity=Monthly kullanır. Geçmiş verileri, dört uç noktası için belgelenen daha dar kurallara tabidir.

Yalnızca dünya geneli veriler desteklenir (country=999). keys alanının arama anahtar kelimesi olduğu anahtar kelime sıralama uç noktası dışında, web sitesi tanımlayıcıları example.com gibi alan adlarıdır. Üst kaynakta veri bulunabilirliği, filtreler ve eşleme türleri değişebilir. Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce 999 olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.

Başarılı yanıtlar evrensel bir yanıt şeması benimsemek yerine yerel JSON yapısını korur. Gelen ve giden yönlendirme tabloları Records kullanır; geçmiş metrikler iç içe Data kullanabilir. Aşağıda açıklanan adlar ve birimler, üst kaynağın isteğe bağlı her alanının her zaman mevcut olduğu anlamına gelmez.

Uç noktalar

Anahtar kelime önerileri

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

Varsayılanlar: country 999, latest 28d, rowsPerPage 100, type Broad, websource Total ve azalan windowVolume. İsteğe bağlı page 1'den başlar. rangeFilter yerel sözdizimini kullanır; örneğin volume,100,10000|difficulty,0,40. Eşleme türlerinin ve filtrelerin kullanılabilirliği veri kaynağına bağlıdır. Yalnızca dünya geneli veriler desteklenir (country=999).

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keyword`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sort`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`asc`	Hayır	Boolean dizesi: true veya false
`page`	Hayır	Tam sayı dizesi; 1-1000
`rowsPerPage`	Hayır	Tam sayı dizesi; 1-1000
`type`	Hayır	Dize; izin verilenler: Broad, Phrase, Exact, Related
`websource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`isWindow`	Hayır	Boolean dizesi: true veya false
`rangeFilter`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Geri bağlantılar

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

Varsayılanlar: Page 1, PageSize 100, Status All, FollowType All ve azalan DomainScore. Key büyük harfle başlar; key veya keys kullanmayın.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`Key`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`Page`	Hayır	Tam sayı dizesi; 1-1000
`PageSize`	Hayır	Tam sayı dizesi; 1-1000
`Status`	Hayır	Dize; izin verilenler: All, Active, New, Lost
`FollowType`	Hayır	Dize; izin verilenler: All, DoFollowOnly, NoFollowOnly, DoFollow, NoFollow
`DomainScoreFrom`	Hayır	Tam sayı dizesi; 0-100
`DomainScoreTo`	Hayır	Tam sayı dizesi; 0-100
`sort`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`asc`	Hayır	Boolean dizesi: true veya false

Web sitesi anahtar kelimeleri

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

Varsayılanlar: page 1, pageSize 100, sourceType all ve her iki marka bayrağı false. pageFilterJson, URL kodlamalı tek bir JSON dizisi dizesidir; belirtilmezse keys bir alan adı olarak hedeflenir. Açık bir from/to aralığı yoksa: latest=1m, açıkça belirtilmedikçe pageSize 5 ve isWindow=false ile bir aylık genel bakış modunu seçer. Marka içermeyen anahtar kelime görünümleri için sourceType=organic veya paid ile IncludeNoneBranded=true ve IncludeBranded=false kullanın.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sort`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`asc`	Hayır	Boolean dizesi: true veya false
`iso`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`isDaily`	Hayır	Boolean dizesi: true veya false
`IncludeBranded`	Hayır	Boolean dizesi: true veya false
`IncludeNoneBranded`	Hayır	Boolean dizesi: true veya false
`page`	Hayır	Tam sayı dizesi; 1-1000
`pageSize`	Hayır	Tam sayı dizesi; 1-1000
`sourceType`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`pageFilterJson`	Hayır	JSON dizisi içeren dize

Anahtar kelimede sıralanan web siteleri

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

keys bir anahtar kelimedir, web sitesi alan adı değildir. Varsayılanlar selectedPageTab=Organic, sourceType=organic, Device=Total ve graphDuration=28d içerir. İsteğe bağlı page 1'den başlar; pageSize pozitif tam sayı kullanır.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sort`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`asc`	Hayır	Boolean dizesi: true veya false
`iso`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`isDaily`	Hayır	Boolean dizesi: true veya false
`tab`	Hayır	Negatif olmayan tam sayı dizesi
`mtd`	Hayır	Boolean dizesi: true veya false
`selectedPageTab`	Hayır	Dize; izin verilenler: Organic, Paid
`graphDuration`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`graphType`	Hayır	Tam sayı dizesi; 1-1000
`isDurationChanged`	Hayır	Boolean dizesi: true veya false
`ignoreFilterConsistency`	Hayır	Boolean dizesi: true veya false
`Device`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sourceType`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`page`	Hayır	Tam sayı dizesi; 1-1000
`pageSize`	Hayır	Tam sayı dizesi; 1-1000

Trafik kaynakları

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

Varsayılanlar: sourceType=Referral, page=1, orderBy=Share desc ve timeGranularity=Daily. Bu tablo gelen yönlendirmeler uç noktasından ayrıdır.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sourceType`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`ignoreFilterConsistency`	Hayır	Boolean dizesi: true veya false
`page`	Hayır	Tam sayı dizesi; 1-1000
`orderBy`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Giden trafik

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

from ve to zorunludur. Yalnızca tekil key kullanılır. Varsayılanlar: country=999, isWWW=false, isWindow=false, webSource=Total, page=1, orderby=Share desc, orderBy=Share desc, sort=Share, asc=false. orderby ve orderBy ayrı alanlardır ve bağımsız iletilir; tutarlı tutun. latest, pageSize, rowsPerPage, includeSubDomains veya timeGranularity kabul edilmez. Satırlar Records içindedir; TotalCount mevcut sayfa uzunluğu değil, üst kaynağın toplamıdır. Yalnızca dünya geneli veriler desteklenir (country=999).

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`key`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Evet	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Evet	Dize; yukarıdaki biçimlerde geçerli tarih
`isWWW`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`orderby`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`orderBy`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`sort`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`asc`	Hayır	Boolean dizesi: true veya false
`page`	Hayır	Tam sayı dizesi; 1-1000

Gelen yönlendirmeler

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

Yalnızca tekil key kullanılır. Varsayılanlar: 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 veya timeGranularity kabul edilmez. Satırlar Records içindedir; yerel alanlar SiteOrigins ve TotalShare içerebilir. Yalnızca dünya geneli veriler desteklenir (country=999).

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`key`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`isWWW`	Hayır	Boolean dizesi: true veya false
`iso`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`isWindow`	Hayır	Boolean dizesi: true veya false
`isDaily`	Hayır	Boolean dizesi: true veya false
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`selectedTab`	Hayır	Dize; izin verilenler: incomingTraffic
`orderBy`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`ignoreFilterConsistency`	Hayır	Boolean dizesi: true veya false
`page`	Hayır	Tam sayı dizesi; 1-1000

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

Varsayılan önceki tam UTC ayıdır. duration, 1m olarak sabittir.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`duration`	Hayır	Dize; izin verilenler: 1m

Trafiğin coğrafi dağılımı

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

Varsayılanlar önceki üç tam UTC ayı, pageSize=5 ve orderBy=TotalShare desc değerleridir.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`pageSize`	Hayır	Tam sayı dizesi; 1-1000
`orderBy`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Cihaz dağılımı

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

Varsayılanlar önceki üç tam UTC ayı ve ShouldGetVerifiedData=false değeridir.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`ShouldGetVerifiedData`	Hayır	Boolean dizesi: true veya false

Arama performansı

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

Varsayılanlar önceki tam UTC ayı, pageSize=5, duration=1m ve SourceType=Organic değerleridir. Ücretli anahtar kelimeler için SourceType=Paid kullanın; sourceType ile değiştirmeyin.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`pageSize`	Hayır	Tam sayı dizesi; 1-1000
`duration`	Hayır	Dize; izin verilenler: 1m
`SourceType`	Hayır	Dize; izin verilenler: Organic, Paid

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

Varsayılan önceki üç tam UTC ayıdır. webSource kabul edilmez.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Etkileşime genel bakış

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

Varsayılanlar ShouldGetVerifiedData=false, includeLeaders=true ve unBounced=false içerir. Yerel Data satırları AvgMonthVisits, BounceRate, PagesPerVisit ve AvgVisitDuration içerebilir.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`ShouldGetVerifiedData`	Hayır	Boolean dizesi: true veya false
`includeLeaders`	Hayır	Boolean dizesi: true veya false
`unBounced`	Hayır	Boolean dizesi: true veya false
`beta`	Hayır	Boolean dizesi: true veya false

Toplam ziyaretler

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

compareFrom ve compareTo, geçerli ve sıralı tarihler olarak birlikte verilmelidir. timeGranularity, Monthly değerindedir. Yerel alanlar TotalVisits, Change ve ShareOfVisits içerebilir; kayan toplam mutlaka tam takvim ayı toplamı değildir.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`compareFrom`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`compareTo`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`ShouldGetVerifiedData`	Hayır	Boolean dizesi: true veya false

Ziyaret tablosu

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

compareFrom ve compareTo, geçerli ve sıralı tarihler olarak birlikte verilmelidir. timeGranularity, Monthly değerindedir; satırlar Domain ve TotalVisits ile Data içindedir. Data satır içerse bile TotalCount 0 olabilir; sonuç bulunup bulunmadığını belirlemek için dizinin kendisini inceleyin.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`compareFrom`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`compareTo`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`ShouldGetVerifiedData`	Hayır	Boolean dizesi: true veya false

Ziyaret eğilimi

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

Varsayılan, kayan 28 günlük günlük penceredir. timeGranularity, Daily, Weekly veya Monthly kabul eder.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Weekly, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`ShouldGetVerifiedData`	Hayır	Boolean dizesi: true veya false

Web sitesi sıralamaları

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

timeGranularity, Monthly değerindedir. Yerel yanıt ayrı GlobalRank, CountryRank ve CategoryRank nesneleri kullanır.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Ülke sıralamaları

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

timeGranularity, Monthly değerindedir. Bu, birleşik sıralama yanıtı değil, açık ülke sıralama tablosudur. Satırlar Domain ve Rank ile Data içindedir. Satırlar bulunsa bile TotalCount 0 olabilir; doğrudan Data alanını inceleyin.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Küresel sıralamalar

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

timeGranularity, Monthly değerindedir. Ayrı küresel sıralama tablosunu döndürür. Satırlar Domain ve Rank ile Data içindedir. Satırlar bulunsa bile TotalCount 0 olabilir; doğrudan Data alanını inceleyin.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Kategori sıralamaları

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

timeGranularity, Monthly değerindedir. Ayrı sektör/kategori sıralama tablosunu döndürür. Satırlar Domain ve Rank ile Data içindedir. Satırlar bulunsa bile TotalCount 0 olabilir; doğrudan Data alanını inceleyin.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Trafik kanalları

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

Varsayılan, kayan 28 günlük günlük penceredir. webSource=Total olduğunda kanal değerleri doğrudan Data[domain] altında değil, Data.Total[domain] altındadır. Search - Organic ve Direct gibi kanal adları korunur. Değerler ziyaret sayılarıdır; payları yalnızca toplamları pozitif olduğunda hesaplayın.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Daily, Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Benzer siteler

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

Varsayılan önceki üç tam UTC ayıdır. isWindow false olmalıdır, timeGranularity Monthly değerindedir ve orderBy, Affinity desc olarak sabittir. latest veya webSource kabul edilmez.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`orderBy`	Hayır	Dize; izin verilenler: Affinity desc

Benzer site önerileri

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

Tekil key kullanılır; limit varsayılan olarak 20'dir ve 1-20 aralığında olmalıdır. country varsayılan olarak 999, webSource ise Total değerindedir. Gözlemlenen yerel yanıt, Domain, DomainWithoutSub, sayısal Rank ve Favicon içeren sarmalanmamış bir aday dizisidir; Data zarfı beklemeyin. Boş dizi öneri içermez. Yalnızca dünya geneli veriler desteklenir (country=999).

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`key`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`limit`	Hayır	Tam sayı dizesi; 1-20
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb

Aylık ziyaret geçmişi

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

Varsayılan olarak önceki altı tam UTC ayı kullanılır. Yalnızca country=999, isWindow=false ve timeGranularity=Monthly desteklenir. latest, 1m ile 6m arasındaki değerleri kabul eder; açık tarihler bu kayan altı aylık pencere içinde tam ayları kapsamalıdır. Yerel seriler, Key/Value noktalarıyla Data.<domain>.<source> altında görünebilir; MobileWeb veya Mobile Web dahil kaynak adları korunur. Değerler tahmini ziyaretleri temsil eder.

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Aylık hemen çıkma oranı geçmişi

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

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Aylık ziyaret süresi geçmişi

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

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt

Aylık ziyaret başına sayfa geçmişi

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

Sorgu alanı	Zorunlu	Tür ve kısıtlamalar
`keys`	Evet	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt
`country`	Hayır	Negatif olmayan tam sayı dizesi; Yalnızca dünya geneli veriler desteklenir (`country=999`). Diğer geçerli ülke değerleri, üst hizmete istek gönderilmeden önce `999` olarak değiştirilir; belirtilen ülkenin değil, dünya genelinin verileri döndürülür.
`from`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`to`	Hayır	Dize; yukarıdaki biçimlerde geçerli tarih
`includeSubDomains`	Hayır	Boolean dizesi: true veya false
`isWindow`	Hayır	Boolean dizesi: true veya false
`webSource`	Hayır	Dize; izin verilenler: Total, Desktop, MobileWeb
`timeGranularity`	Hayır	Dize; izin verilenler: Monthly
`latest`	Hayır	Dize; kenar boşlukları kırpıldıktan sonra 1-2048 UTF-8 bayt