Similarweb website traffic dataset API
Traffic and Engagement are the fundamental data points of Similarweb - allowing our customers to have the digital measures of the world at the palm of their hands.
The Dataset is utilizing multiple tables.
When generating a report, make sure all metrics are supported by same granularity as the requested report.
Data credits are Similarweb's currency. Each result (cell) in a report costs one data credit.
As pricing may vary from report to report you can estimate the total credit amount for each report generated by our Request-Validate endpoint.
*Note - if there are no results, no credits are charged.
Batch API and REST API have different Keys
Make sure you're using the correct API Key with the query
Traffic & Engagement Table:
Table URL: https://api.similarweb.com/v3/batch/traffic_and_engagement/request-report
Primary Keys: domains, countries
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| all_traffic_visits, desktop_visits, mobile_visits | Returns estimated number of visits for the domain. | Monthly, Weekly, Daily | Double |
| all_page_views, desktop_page_views, mobile_page_views | Returns the total number of pageviews for the selected domain. | Daily | Double |
| all_traffic_pages_per_visit, desktop_pages_per_visit, mobile_pages_per_visit | Returns the average page views per visit for the given domain. | Monthly, Weekly, Daily | Double |
| all_traffic_average_visit_duration, desktop_average_visit_duration, mobile_average_visit_duration | Returns the average visit duration on the given domain (in seconds). | Monthly, Weekly, Daily | Double |
| all_traffic_bounce_rate, desktop_bounce_rate, mobile_bounce_rate | Returns the bounce rate for the given domain. | Monthly, Weekly, Daily | Double |
| deduplicated_audience | Returns the average number of individuals who visited across desktop and mobile. | Monthly | Double |
| desktop_unique_visitors, mobile_unique_visitors | Returns unique desktop/mobile visitors. | Monthly, Daily | Double |
| desktop_vs_mobile_split | Returns desktop vs. mobile web traffic share split. This metric costs 2 data points (desktop and mobile). | Monthly | Double |
| desktop_ppc_spend_usd, mobile_ppc_spend_usd | Returns an estimation of the domain spending on PPC search terms on desktop/mobile. | Monthly | Double |
| desktop_new_visitors | Returns the unique users that were not spotted visiting the site for at least three months, the remaining visitors are returning visitors. | Monthly | Double |
| desktop_returning_visitors | Returns the unique users that were not spotted visiting the site for at least three months, the remaining visitors are returning visitors. | Monthly | Double |
| global_rank | Returns SimilarWeb's monthly Global Rank for a given domain. | Monthly | Integer |
| country_rank | Returns SimilarWeb's monthly Country Rank for a given domain. | Monthly | Integer |
| category_rank_new | Returns the Global Rank within its given category. | Monthly | Integer |
| category | Returns the top category associated with the domain. | Monthly | String |
Marketing Channels:
Returns the overview of traffic sources driving mobile web traffic to the domain broken down by source type and traffic share.
Table URL: https://api.similarweb.com/v3/batch/marketing_channels/request-report
Traffic sources available: organic_search, direct, paid_search, referrals, display_ads, social, mail, search
Primary Keys: domains, countries
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| desktop_marketing_channels | Returns the overview of traffic sources by visits and share for desktop sources. | Monthly | Array |
| mobile_marketing_channels | Returns the overview of traffic sources by visits and share for mobile sources. | Monthly | Array |
Similar sites:
Table URL: https://api.similarweb.com/v3/batch/similar_sites/request-report
Primary Keys: domain1, domain2
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| site_affinity | Returns a similarity grade of two websites (Similar sites). | Monthly | Double |
Desktop Top Geo:
Table URL: https://api.similarweb.com/v3/batch/desktop_top_geo/request-report
Primary Key: domain
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| desktop_top_geo | Returns the desktop traffic share broken down by the top 10 countries driving traffic to the website, between the selected dates (min. 1 month). The countries are represented by their two-letter country codes. | Monthly | Array |
Traffic Sources:
Table URL: https://api.similarweb.com/v3/batch/traffic_sources/request-report
Primary Keys: domains, countries
Traffic sources available: organic_search, direct, paid_search, referrals, display_ads, social, mail, search
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| desktop_traffic_source_share | Returns the distinct sources driving traffic to websites. For example: youtube, Google UK, facebook, Bing and more. | Monthly | Array |