SimilarWeb Scraper - Website Traffic & Analytics (Official API)

Fetch website traffic and ranking data from the official Similarweb REST API using your own Similarweb API key. For each domain you can retrieve global rank, category rank and category, estimated monthly visits, pages per visit, average visit duration, and bounce rate. Export clean results to JSON, CSV, Excel, or HTML, or pull them through the Apify API.

Important: this is a bring-your-own-key Actor. It calls the official Similarweb API on your behalf and does not scrape SimilarWeb public pages. You need a valid Similarweb subscription/API key with API access. Runs without a key fail immediately and are not charged the website-scraped event.

What You Need

• A Similarweb account with API access and an API key. You can find your key in your Similarweb account (Account settings > API, or as provided by your Similarweb plan). See the official Similarweb API documentation for details.
• Each domain lookup consumes your own Similarweb API credits, in addition to Apify usage.

What It Extracts

For each domain, when your Similarweb plan returns the data:

• Domain
• Global rank
• Category rank and category
• Estimated monthly visits (latest month in the selected range)
• Pages per visit
• Average visit duration (seconds)
• Bounce rate (percent)
• Country scope, date range, SimilarWeb profile URL, and scraped timestamp

Any metric your subscription does not include, or that Similarweb has no data for, is returned as null. The Actor never fabricates values.

Input

Field	Type	Required	Default	Description
apiKey	string (secret)	Yes	–	Your official Similarweb API key.
domains	string array	Yes	["openai.com"]	Domains to look up, without https:// or www..
maxResults	integer	No	1	Max domains from the list to query. Each domain uses your Similarweb credits.
country	string	No	world	world or a two-letter ISO country code (e.g. us, gb, in), if included in your plan.
startDate	string	No	recent month	Start month YYYY-MM for traffic/engagement metrics.
endDate	string	No	recent month	End month YYYY-MM. The latest available value in the range is kept.

Example Input

{
  "apiKey": "YOUR_SIMILARWEB_API_KEY",
  "domains": ["openai.com"],
  "maxResults": 1,
  "country": "world"
}

Output Shape

Values below are illustrative; real values come from your Similarweb API response. Missing metrics are null.

{
  "domain": "openai.com",
  "country": "world",
  "startDate": "2026-03",
  "endDate": "2026-05",
  "globalRank": 201,
  "categoryRank": 6,
  "category": "Computers_Electronics_and_Technology",
  "monthlyVisits": 210500000,
  "pagesPerVisit": 2.81,
  "avgVisitDuration": 144.79,
  "bounceRate": 58.2,
  "source": "similarweb-official-api",
  "similarWebUrl": "https://www.similarweb.com/website/openai.com/",
  "scrapedAt": "2026-07-02T20:00:00.000Z"
}

Pricing and Usage

This Actor uses Apify Pay Per Event pricing. You are charged once per domain that returns real data from the official Similarweb API. Domains with no data, failed API responses, or an invalid/unauthorized API key are not charged the website-scraped event.

Separately, every domain lookup consumes your own Similarweb API credits, and Apify platform compute is billed per your plan. Start with one domain and maxResults: 1 to confirm your key and plan coverage before larger batches.

How It Works

1. Validates input and fails fast if no API key is provided (before any network request or website-scraped billing).
2. Normalizes and deduplicates the domain list.
3. For each domain, calls the official Similarweb REST API endpoints for rank, category rank, visits, pages per visit, average visit duration, and bounce rate.
4. Maps only the values the API actually returns into a clean, nullable-safe record.
5. Saves and charges one website-scraped event only when at least one real metric was returned.
6. Fails clearly if no usable metrics are returned for any requested domain, so the run never appears as a successful empty dataset.
7. Stops immediately if the account spending limit is reached, and fails fast with a clear message if the API key is rejected (HTTP 401).

Known Limits

• Requires a valid Similarweb API subscription and key. This Actor does not provide Similarweb data on its own.
• Available metrics, countries, and history depend on your Similarweb plan. Endpoints not in your plan return null for those fields.
• Similarweb data typically lags the current month by one to two months.
• This Actor is not affiliated with Similarweb.

Responsible Use

Use only in accordance with your Similarweb API subscription and terms. You are responsible for ensuring your use complies with Similarweb's terms and applicable laws.

License

Apache-2.0. See LICENSE.