# Similarweb API — website traffic, rank, traffic sources, competitors, keywords, audience, AI-chatbot traffic, company data, top websites, app ranks and top charts, Amazon shopper data

> Everything Similarweb publishes for free about one website, from one request: estimated monthly visits (last 3 months), visit change, bounce rate, pages per visit, average visit duration; traffic sources; top countries with share; global, country and category rank with history and the sites ranked next to it; audience age and gender; interests; the 10 most similar competitors; organic vs paid search share, keyword count and top keywords with CPC; top referring and outgoing sites and categories; social networks; display-ad sites, ad networks and recent ad creatives; technologies by category; company name, founding year, headquarters, employee and revenue range. Data month = `data_month`.
> ReefAPI engine `similarweb` · 20 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/similarweb/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/similarweb/v1/website — 1 credit
Everything Similarweb publishes for free about one website, from one request: estimated monthly visits (last 3 months), visit change, bounce rate, pages per visit, average visit duration; traffic sources; top countries with share; global, country and category rank with history and the sites ranked next to it; audience age and gender; interests; the 10 most similar competitors; organic vs paid search share, keyword count and top keywords with CPC; top referring and outgoing sites and categories; social networks; display-ad sites, ad networks and recent ad creatives; technologies by category; company name, founding year, headquarters, employee and revenue range. Data month = `data_month`.

**Parameters:**
- `domain` (string, required) — A domain (shopify.com), a full URL (https://www.shopify.com/pricing) or a similarweb.com link. www. is dropped; subdomains are kept (blog.shopify.com is its own site).

**Returns:** domain, similarweb_url, snapshot_date, data_month, description, category_id, favicon, traffic{visits, visits_change, bounce_rate, pages_per_visit, avg_visit_duration, avg_visit_duration_seconds, visits_scale, monthly_visits[]{month, visits, visits_change, visits_derived}, compared_with[]}, traffic_sources[]{source, share, rank}, ranks{global_rank, country, country_rank, category_rank (+ _previous, _change), *_rank_history[]{month, rank}, *_rank_neighbours[]{rank, domain}}, geography{countries_total, top_countries[]{country, share, share_change}}, demographics{age[]{min_age, max_age, share}, gender{male, female}}, interests{websites_total, top_websites[], top_topics[], top_categories[]}, competitors[]{domain, affinity, category_id, category_rank}, keywords{organic_share, paid_share, keywords_total, top_keywords[]{keyword, volume, cpc, estimated_value}}, referrals{incoming_sites_total, top_incoming_sites[]{domain, share, locked}, top_incoming_categories[], outgoing_sites_total, top_outgoing_sites[], top_outgoing_categories[]}, social{networks_total, top_networks[]{name, share}}, ads{ad_sites_total, ad_networks_total, top_ad_sites[], recent_ads[]{creative_id, preview, width, height, active_days}, more_ads}, technologies{technologies_total, categories_total, categories[]{category_id, top_technology, technologies_total}}, company{name, year_founded, headquarters_country, headquarters_city, employees_min, employees_max, revenue_min, revenue_max, revenue_currency, parent_domain}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/competitors — 3 credits
Similarweb's competitor table for a website: up to 10 rival sites, each with its global, country and category rank and their change, bounce rate, pages per visit, visit duration, category, company and similarity (affinity); plus the same metrics for the site itself.

**Parameters:**
- `domain` (string, required) — A domain (shopify.com), a full URL (https://www.shopify.com/pricing) or a similarweb.com link. www. is dropped; subdomains are kept (blog.shopify.com is its own site).

**Returns:** domain, similarweb_url, snapshot_date, site{domain, global_rank, country, country_rank, category_rank (+ _change), bounce_rate, pages_per_visit, avg_visit_duration(_seconds), category_id, company_name}, competitors[]{same fields + affinity, description}

**Example request body:**
```json
{
  "domain": "github.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/similar_sites — 1 credit
Up to 20 similar websites from similarsites.com (Similarweb's similarity service), each with a similarity score and rank, monthly visits, top-country rank, category and description; plus the site's own title, tags, category rank, visits and related mobile apps.

**Parameters:**
- `domain` (string, required) — A domain (shopify.com), a full URL (https://www.shopify.com/pricing) or a similarweb.com link. www. is dropped; subdomains are kept (blog.shopify.com is its own site).

**Returns:** domain, title, description, category_id, category_rank, visits, tags[], similar_sites[]{domain, similarity_rank, similarity_score, description, category_id, top_country_rank, visits, thumbnail}, related_apps[]{title, store, rank, url, icon}

**Example request body:**
```json
{
  "domain": "github.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/ai_traffic — 3 credits
Visits a website receives from AI chatbots (ChatGPT, Claude, Gemini, Perplexity, Copilot, Grok, DeepSeek …): total AI referral visits for the month, AI share of all traffic, the chatbots ranked, the share of the top ones with 3-month history, and the prompts Similarweb lists for the site.

**Parameters:**
- `domain` (string, required) — A domain (shopify.com), a full URL (https://www.shopify.com/pricing) or a similarweb.com link. www. is dropped; subdomains are kept (blog.shopify.com is its own site).

**Returns:** domain, similarweb_url, snapshot_date, ai_visits, ai_share_of_traffic, ai_visits_scale, chatbots[]{name, rank, share, share_history[]{month, share}}, top_prompts[], company{…}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/company — 3 credits
Similarweb's company page for a domain: name, public/private, description, email, phone, founding year, headquarters, employee and revenue range, revenue by year, stock tickers, subsidiaries, monthly visits / visit duration / pages per visit (3 months), competitor companies with their visits, recent news, technologies and the category benchmark (category visits, top companies). Only larger companies have a page.

**Parameters:**
- `domain` (string, required) — A domain (shopify.com), a full URL (https://www.shopify.com/pricing) or a similarweb.com link. www. is dropped; subdomains are kept (blog.shopify.com is its own site).

**Returns:** domain, name, type, category_id, description, email, phone, year_founded, headquarters_country, headquarters_city, employees_min/max, revenue_min/max, revenue_currency, revenue_by_year[], stock_tickers[]{symbol, exchange}, subsidiaries[], monthly[]{month, visits, avg_visit_duration_seconds, pages_per_visit}, competitors[]{name, domain, visits, employees_min, revenue_min, headquarters_city}, news[]{date, title, description, url}, technologies{…}, category_benchmark{category_visits, top_companies[]}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/top_websites — 1 credit
The 50 most visited websites worldwide or in one country, or in one category / subcategory, in rank order, with rank change, category, bounce rate, pages per visit and visit duration. A country together with a category returns that category's top 5 (the source's own limit).

**Parameters:**
- `country` (string, optional) — ISO country code (US, DE, GB …) or Similarweb country slug (united-states). Leave empty for worldwide.
- `category` (string, optional) — Top-level website category, e.g. arts-and-entertainment, e-commerce-and-shopping, finance (list: action top_websites_filters). Empty = all categories.
- `subcategory` (string, optional) — Subcategory of `category`, e.g. music under arts-and-entertainment (list: top_websites_filters). Needs `category`.

**Returns:** country, category_id, snapshot_date, websites[]{rank, domain, rank_change, new_in_ranking, category_id, bounce_rate, pages_per_visit, avg_visit_duration(_seconds)}

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/similarweb/v1/trending_websites — 1 credit
Movers among the top websites worldwide or in one country / category: biggest risers and fallers, sites that entered and sites that left the top list, with rank and rank change.

**Parameters:**
- `country` (string, optional) — ISO country code (US, DE, GB …) or Similarweb country slug (united-states). Leave empty for worldwide.
- `category` (string, optional) — Top-level website category, e.g. arts-and-entertainment, e-commerce-and-shopping, finance (list: action top_websites_filters). Empty = all categories.
- `subcategory` (string, optional) — Subcategory of `category`, e.g. music under arts-and-entertainment (list: top_websites_filters). Needs `category`.

**Returns:** country, category_id, snapshot_date, rising[]{domain, rank, rank_change, totally_new}, falling[], entered_top[], left_top[]

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/similarweb/v1/top_websites_filters — 3 credits
The countries and website categories / subcategories the top-websites ranking accepts.

**Parameters:** none

**Returns:** snapshot_date, countries[]{country, country_slug}, categories[]{category, category_id, subcategories[]}

### POST https://api.reefapi.com/similarweb/v1/search — 2 credits
Search Similarweb for websites, Google Play apps, App Store apps and companies matching a word or brand: up to 30 of each, with description, category and identifiers to pass to website / app / company.

**Parameters:**
- `query` (string, required) — A word, brand or partial domain.

**Returns:** query, websites[]{domain, description, category_id}, google_play_apps[]{app_id, name, publisher, category_id, description}, app_store_apps[], companies[]{domain, name, category_id, description}

**Example request body:**
```json
{
  "query": "nike"
}
```

### POST https://api.reefapi.com/similarweb/v1/autocomplete — 1 credit
Similarweb's search-box suggestions: up to 10 websites and up to 10 apps per store for a prefix, apps with their ratings count.

**Parameters:**
- `query` (string, required) — The start of a domain, brand or app name.
- `type` (enum, optional, default "all") — What to suggest. [one of: all, websites, apps]

**Returns:** query, websites[]{domain}, google_play_apps[]{app_id, name, publisher, ratings_count}, app_store_apps[]

**Example request body:**
```json
{
  "query": "nike"
}
```

### POST https://api.reefapi.com/similarweb/v1/app — 3 credits
One Google Play or App Store app on Similarweb: name, publisher, category, rating, description, last release; store rank, category rank and usage rank (US, or `country`) with a 28-day daily rank history; the countries where it ranks highest; audience interests (other app categories its users use) and competing apps.

**Parameters:**
- `app_id` (string, required) — Google Play package (com.whatsapp), App Store numeric id (310633997) or a Play / App Store link.
- `store` (enum, optional) — google or apple. Optional: a numeric id means the App Store, a package name Google Play. [one of: google, apple]
- `country` (string, optional) — Ranks, 28-day rank history and audience interests for US (default), DE or BR — the only countries Similarweb serves app ranks for without an account (measured 2026-11-15: 93 of 96 Google Play countries and GB / FR / JP on the App Store answer 400).

**Returns:** app_id, store, name, publisher, category_id, price_model, rating, last_release_date, description, ranks_country, ranks{store_rank, category_store_rank, usage_rank, category_usage_rank}, rank_history[]{date, …ranks}, top_countries{store_rank[]{country, rank, rank_change}, usage_rank[], category_store_rank[], category_usage_rank[]}, audience_interests[]{category_id, affinity, top_apps[]}, competitors[]{app_id, name, publisher}, countries_available[]

**Example request body:**
```json
{
  "app_id": "com.whatsapp"
}
```

### POST https://api.reefapi.com/similarweb/v1/top_apps — 1 credit
A Google Play or App Store top chart (free, paid or grossing) for a country and category, today or a past day: 51 apps with store rank and its change, Similarweb usage rank and its change, publisher, category. Sort by store rank or by usage rank (usage rank is published for Google Play in 30 countries).

**Parameters:**
- `store` (enum, required) — Which app store. [one of: google, apple]
- `country` (string, optional, default "US") — ISO country code or Similarweb country slug (list: app_filters). Default US.
- `category` (string, optional) — Store category, e.g. games, finance, shopping (list: app_filters). Empty = all categories.
- `subcategory` (string, optional) — Subcategory of `category` (games and family on Google Play; games and newsstand on the App Store), e.g. action.
- `chart` (enum, optional, default "free") — Which top chart. [one of: free, paid, grossing]
- `device` (enum, optional, default "iphone") — App Store charts only: iPhone or iPad chart (ignored for Google Play). [one of: iphone, ipad]
- `sort` (enum, optional, default "store_rank") — Order of the chart. [one of: store_rank, usage_rank]
- `date` (string, optional) — The chart on one past day (YYYY-MM-DD). Similarweb keeps the daily charts from the first day of the previous month up to its latest snapshot (measured 2026-11-15: 2026-10-01 … 2026-11-12); empty = latest.

**Returns:** store, country, chart, device, date, snapshot_date, sort, usage_rank_published, apps[]{app_id, name, publisher, category_id, store_rank, store_rank_change, store_rank_new, usage_rank, usage_rank_change, icon}

**Example request body:**
```json
{
  "store": "google"
}
```

### POST https://api.reefapi.com/similarweb/v1/trending_apps — 1 credit
Movers on a Google Play or App Store chart: apps rising and falling fastest, apps that entered and that left the chart, with store and usage rank and their change.

**Parameters:**
- `store` (enum, required) — Which app store. [one of: google, apple]
- `country` (string, optional, default "US") — ISO country code or Similarweb country slug (list: app_filters). Default US.
- `category` (string, optional) — Store category, e.g. games, finance, shopping (list: app_filters). Empty = all categories.
- `subcategory` (string, optional) — Subcategory of `category` (games and family on Google Play; games and newsstand on the App Store), e.g. action.
- `chart` (enum, optional, default "free") — Which top chart. [one of: free, paid, grossing]
- `device` (enum, optional, default "iphone") — App Store charts only: iPhone or iPad chart (ignored for Google Play). [one of: iphone, ipad]

**Returns:** store, country, category_id, chart, snapshot_date, rising[]{app_id, name, publisher, store_rank, store_rank_change, usage_rank, usage_rank_change}, falling[], entered_top[], left_top[]

**Example request body:**
```json
{
  "store": "google"
}
```

### POST https://api.reefapi.com/similarweb/v1/app_filters — 1 credit
The countries (with usage-rank availability), categories, subcategories, charts and devices both app stores accept in top_apps / trending_apps.

**Parameters:** none

**Returns:** google{countries[]{country, country_slug, usage_rank_available}, categories[]{category, subcategories[]}, charts[], devices[]}, apple{…}

### POST https://api.reefapi.com/similarweb/v1/browser_market_share — 1 credit
Browser market share (Chrome, Safari, Edge, Firefox, Samsung Internet, Opera …) worldwide or in a country, all devices or desktop / tablet only: current shares, 12-month history and, worldwide, the leading browser in each country. (A mobile-phone-only split is not published by Similarweb.)

**Parameters:**
- `country` (string, optional) — ISO country code (US, DE, GB …) or Similarweb country slug (united-states). Leave empty for worldwide.
- `platform` (enum, optional) — Only this device type. Empty = all devices. [one of: desktop, tablet]

**Returns:** country, platform, snapshot_date, leaders[]{name, share}, history[]{name, months[]{month, share}}, leader_by_country[]{country, leader, share} (worldwide only)

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/similarweb/v1/device_market_share — 1 credit
Share of web traffic by device type (mobile, desktop, tablet) worldwide or in a country: current shares, 12-month history and, worldwide, the leading device in each country.

**Parameters:**
- `country` (string, optional) — ISO country code (US, DE, GB …) or Similarweb country slug (united-states). Leave empty for worldwide.

**Returns:** country, snapshot_date, leaders[]{name, share}, history[]{name, months[]{month, share}}, leader_by_country[]{country, leader, share} (worldwide only)

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/similarweb/v1/technology — 3 credits
One web technology on Similarweb (shopify, google-analytics, wordpress …): category, description, pricing model, number of websites using it, market share, the top websites using it with their traffic share, top countries and website categories, and alternatives.

**Parameters:**
- `technology` (string, required) — Technology name or its Similarweb slug: Shopify, Google Analytics, google-analytics. A website's `technologies.categories[].top_technology` names work too.

**Returns:** technology, name, category, subcategory, website, description, pricing, websites_using, market_share, data_date, top_websites[]{domain, share}, top_countries[]{country, share}, top_categories[]{category_id, share}, alternatives[]{name, category, pricing}

**Example request body:**
```json
{
  "technology": "google-analytics"
}
```

### POST https://api.reefapi.com/similarweb/v1/amazon_top_brands — 3 credits
Similarweb shopper data for an Amazon marketplace, all categories or one: estimated monthly revenue and its change, first-party vs third-party seller share, organic vs paid search share, the top brands (revenue share, product views, conversion rate, average selling price, each with its change), the top products by views and the best-selling subcategory tree with units sold.

**Parameters:**
- `marketplace` (enum, required) — Amazon marketplace. [one of: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.fr, amazon.it]
- `category_id` (string, optional) — Numeric Amazon category id from amazon_categories (or from top_subcategories[].category_id). Empty = all categories.

**Returns:** marketplace, month, currency, category{category_id, name}, revenue{revenue, revenue_change, first_party_share, third_party_share (+ _change)}, search{organic_share, paid_share}, top_brands[]{brand, revenue_share, revenue_share_change_pp, product_views, conversion_rate, average_selling_price, …}, top_products[]{product, brand, category_path[], product_views}, top_subcategories[]{category_id, name, units_sold, subcategories[]}

**Example request body:**
```json
{
  "marketplace": "amazon.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/amazon_categories — 3 credits
The Amazon category tree Similarweb's shopper data covers for one marketplace, with the numeric category ids amazon_top_brands takes.

**Parameters:**
- `marketplace` (enum, required) — Amazon marketplace. [one of: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.fr, amazon.it]

**Returns:** marketplace, categories[]{category_id, name, subcategories[]}, marketplaces_with_categories[]

**Example request body:**
```json
{
  "marketplace": "amazon.com"
}
```

### POST https://api.reefapi.com/similarweb/v1/serp_volatility — 3 credits
Similarweb's Google SERP volatility (risk) index: the daily score for the last 90 days on desktop and mobile, and the current, previous and overall averages.

**Parameters:** none

**Returns:** average_current, average_previous, average_total, desktop{average_current, average_previous, average_total, days[]{date, risk_index}}, mobile{…}

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=similarweb
- Human docs page: https://reefapi.com/docs/similarweb
- Overview page: https://reefapi.com/similarweb-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
