Similarweb API: Get website traffic
Gets a website's monthly traffic estimate, rankings, engagement and top countries from Similarweb's free public overview. Traffic-source percentages withheld by the site are null; the site may limit anonymous views.
Unofficial. Not affiliated with or endorsed by Similarweb.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Website, required
website Website domain or link, such as notion.so or https://notion.so/page.
notion.so
Input as JSON
{ "website": "notion.so"}Output
{ "month": "2026-08-01", "domain": "notion.so", "country": "United States", "category": "Computers Electronics and Technology - Other", "global_rank": 3644, "country_rank": 3480, "category_rank": 111, "top_countries": [ { "country": "United States", "share_percent": 22.16 }, { "country": "Japan", "share_percent": 8.24 }, { "country": "Korea, Republic of", "share_percent": 6.92 } ], "pages_per_visit": 7.35, "similarweb_link": "https://www.similarweb.com/website/notion.so/" , "traffic_sources": { "email": null, "direct": 78.96, "search": null, "social": null, "referrals": null, "display_ads": null }, "bounce_rate_percent": 50.34, "average_visit_duration": "8 min 37 s", "visit_duration_seconds": 517, "estimated_monthly_visits": 11874618, "change_from_previous_month_percent": -0.25}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"similarweb.com/get_website_traffic","input":{"website":"notion.so"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "similarweb.com/get_website_traffic" , "input": { "website": "notion.so" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "similarweb.com/get_website_traffic" , "input": { "website": "notion.so" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run similarweb.com/get_website_traffic# with {"website":"notion.so"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "website" ], "properties": { "website": { "type": "string", "description": "Website domain or link, such as notion.so or https://notion.so/page." } }}Output schema
{ "type": "object", "required": [ "domain", "month", "global_rank", "country_rank", "country", "category", "category_rank", "estimated_monthly_visits", "change_from_previous_month_percent", "bounce_rate_percent", "pages_per_visit", "average_visit_duration", "top_countries", "traffic_sources", "similarweb_link", "visit_duration_seconds" ], "properties": { "month": { "type": "string", "format": "date", "description": "First day of the month covered." }, "domain": { "type": "string", "description": "Website domain." }, "country": { "type": [ "string", "null" ] }, "category": { "type": [ "string", "null" ] }, "global_rank": { "type": [ "integer", "null" ] }, "country_rank": { "type": [ "integer", "null" ] }, "category_rank": { "type": [ "integer", "null" ] }, "top_countries": { "type": "array", "items": { "type": "object", "required": [ "country", "share_percent" ], "properties": { "country": { "type": "string" }, "share_percent": { "type": "number" } }, "additionalProperties": false } }, "pages_per_visit": { "type": [ "number", "null" ] }, "similarweb_link": { "type": "string", "format": "uri" }, "traffic_sources": { "type": "object", "required": [ "direct", "search", "social", "referrals", "email", "display_ads" ], "properties": { "email": { "type": [ "number", "null" ] }, "direct": { "type": [ "number", "null" ] }, "search": { "type": [ "number", "null" ] }, "social": { "type": [ "number", "null" ] }, "referrals": { "type": [ "number", "null" ] }, "display_ads": { "type": [ "number", "null" ] } }, "additionalProperties": false }, "bounce_rate_percent": { "type": [ "number", "null" ] }, "average_visit_duration": { "type": [ "string", "null" ] }, "visit_duration_seconds": { "type": [ "integer", "null" ], "description": "Average time on site in seconds.", "x-fous-developer": true }, "estimated_monthly_visits": { "type": [ "integer", "null" ] }, "change_from_previous_month_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
similarweb.com/get_website_traffic- Returns
- month, global/country/category rank, monthly visits, change, bounce rate, pages per visit, visit duration, top countries, traffic sources
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method similarweb.com/get_website_traffic with the inputs above.
Ask your agent
- How many monthly visits does notion.so get, and what's its global rank right now?
- Pull the Similarweb overview for canva.com — bounce rate, pages per visit, and average visit duration.
- Which countries send the most traffic to duolingo.com? Also show whether visits went up or down last month.
- I'm sizing up a competitor: give me the traffic estimate, category rank, and traffic source breakdown for https://www.allbirds.com/collections/mens.
- Check Similarweb for figma.com's monthly traffic and its rank in the US.
See more
All Similarweb methodsLists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
similarweb.com/list_top_websitesGets a website's worldwide popularity bucket, exact rank when shown, categories, and recent weekly rank history from Cloudflare Radar. Historical rank points are available only for top-100 domains; other ranked domains have an empty history.
radar.cloudflare.com/get_domain_rankGets the technologies shown in a website's free BuiltWith profile, grouped in the order BuiltWith displays them. A company name is matched to its official website through a public web search.
builtwith.com/get_website_technologiesGets a company's Trustpilot rating summary from its name or website: TrustScore, rating label, total reviews, star breakdown, categories, claimed status, reply statistics and location when shown.
trustpilot.com/get_company_ratingChecks a website's HTTPS setup with SSL Labs: overall grade, per-server grades, certificate issuer and expiry, supported protocols and known weaknesses. Reuses cached reports from the last 72 hours unless a fresh test is requested.
ssllabs.com/check_ssl_certificateReturns human-reader view counts for a Wikipedia article by day or month, with totals, daily averages and the peak period.
wikipedia.org/get_page_viewsGets a city's current Numbeo cost of living indices, monthly estimates without rent, and typical prices. Add a country or state to tell apart cities with the same name.
numbeo.com/get_cost_of_livingGets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null.
linkedin.com/get_company_profile