{"openapi":"3.1.0","info":{"title":"Website Traffic Rank API - Chrome Top Sites by Country","version":"1.0.0","description":"How popular a website is with Chrome users: global popularity bucket (Top 1K to Top 1M), 6-month trend, the rank bucket in about 238 countries and a 12-month history, from Google's public Chrome UX Report. One domain or 50 per call. Rank buckets, not visit counts: an honest, free-data alternative to traffic-estimate tools for ranking and qualifying websites.\n\nAll endpoints accept GET (query string) or POST (JSON body). Errors use one shape: `{\"success\": false, \"error\": {\"code\", \"message\", \"retryable\"}}`. When a numeric `Retry-After` header is present, `error.retryAfterSeconds` is included.","contact":{"name":"TidyTools","url":"https://apify.com/tidytools"}},"servers":[{"url":"https://webcapture-api.yukailin.workers.dev","description":"Origin (reachable only through the marketplace gateway)"}],"tags":[{"name":"Website Traffic Rank"}],"paths":{"/api/v1/traffic-rank":{"get":{"operationId":"trafficRankGet","summary":"Website traffic rank of one domain (GET)","description":"How popular a website is with Chrome users, from Google's public Chrome UX Report (CrUX) rank lists: the global popularity bucket over the last 12 months (Top 1K, 5K, 10K, 50K, 100K, 500K, 1M), the 6-month trend, the rank bucket in each of about 238 countries for the latest month, and the monthly history. These are rank buckets of origins with enough Chrome traffic, not visit counts or exact positions: a site outside the lists is not listed in any bucket. Data: Chrome UX Report, CC BY 4.0, refreshed monthly.","tags":["Website Traffic Rank"],"parameters":[{"name":"domain","schema":{"type":"string"},"description":"A domain or website address: `stripe.com`, `https://www.stripe.com/pricing`, `shop.example.co.uk` (the parent domain is used when the exact name is not in the dataset, unless `exact=true`). Alias: `url`.","required":true,"example":"stripe.com","in":"query"},{"name":"countries","schema":{"type":"string"},"description":"Comma-separated two-letter country codes (`us,gb,tw`; `uk` is accepted): the answer gets `rankIn` with the bucket in each, null when not listed there.","required":false,"example":"tw,jp","in":"query"},{"name":"maxCountries","schema":{"type":"integer","default":10,"minimum":0,"maximum":300},"description":"How many countries to list in `countryRanks`, most relevant first (0 = all).","required":false,"in":"query"},{"name":"includeHistory","schema":{"type":"boolean","default":true},"description":"Include the global bucket of each of the last 12 months in `globalHistory`.","required":false,"in":"query"},{"name":"exact","schema":{"type":"boolean","default":false},"description":"`true`: look up exactly this host (no fallback to the parent domain, e.g. `shop.example.com` does not become `example.com`).","required":false,"in":"query"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true,"description":"Always true here."},"input":{"type":"string","description":"What you sent."},"domain":{"type":"string","description":"The domain that matched."},"found":{"type":"boolean","description":"false when the domain is in no Chrome list (single lookups answer 404 instead)."},"globalRank":{"type":"integer","description":"Chrome UX Report popularity bucket worldwide over the last 12 months: 1000, 5000, 10000, 50000, 100000, 500000 or 1000000 (a bucket, not an exact rank). null when not in the global top 1M.","nullable":true},"globalRankLabel":{"type":"string","description":"The bucket as a label, e.g. `Top 10K websites worldwide`.","nullable":true},"trend":{"type":"string","description":"Current bucket vs 6 months ago: `up`, `down`, `stable`, `new` (not listed 6 months ago) or `dropped` (no longer listed).","nullable":true,"enum":["up","down","stable","new","dropped"]},"globalRankSixMonthsAgo":{"type":"integer","description":"The bucket 6 months ago.","nullable":true},"monthsInGlobalTop1M":{"type":"integer","description":"Months (of the last 12) in the global top 1M."},"topCountry":{"type":"string","description":"Country where the site is most popular relative to the size of that country's list (ISO 3166-1 alpha-2, lower case).","nullable":true},"topCountryName":{"type":"string","description":"English name of `topCountry`.","nullable":true},"topCountryRank":{"type":"integer","description":"Bucket in `topCountry`.","nullable":true},"topCountryRankLabel":{"type":"string","description":"e.g. `Top 1K in Italy`.","nullable":true},"countryCount":{"type":"integer","description":"Number of countries (of about 238) whose Chrome list includes the site."},"rankIn":{"type":"object","properties":{"tw":{"type":"integer"},"jp":{"type":"integer"}},"description":"Only with `countries`: the bucket in each country you asked for (null when not listed there)."},"countryRanks":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"countryName":{"type":"string"},"rank":{"type":"integer"},"rankLabel":{"type":"string"}}},"description":"Country buckets, most relevant first (`maxCountries` of them; 0 = all)."},"globalHistory":{"type":"array","description":"Global bucket per month, oldest first (with `includeHistory=true`).","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"rank":{"type":"integer","nullable":true}}}},"summary":{"type":"string","description":"One plain-English line."},"origin":{"type":"string","description":"The origin (scheme and host) the Chrome list uses for the domain.","nullable":true},"dataset":{"type":"object","additionalProperties":true,"description":"Data release, month and sources (Chrome UX Report, CC BY 4.0).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"dataMonth":{"type":"string","description":"Month of the country lists, YYYY-MM."},"countriesCovered":{"type":"integer"},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"input":"stripe.com","domain":"stripe.com","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"stable","globalRankSixMonthsAgo":10000,"monthsInGlobalTop1M":12,"topCountry":"it","topCountryName":"Italy","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Italy","countryCount":220,"rankIn":{"tw":10000,"jp":50000},"countryRanks":[{"country":"it","countryName":"Italy","rank":1000,"rankLabel":"Top 1K"},{"country":"us","countryName":"United States","rank":5000,"rankLabel":"Top 5K"},{"country":"gb","countryName":"United Kingdom","rank":5000,"rankLabel":"Top 5K"},{"country":"fr","countryName":"France","rank":5000,"rankLabel":"Top 5K"}],"globalHistory":[{"month":"2025-09","rank":50000},{"month":"2025-10","rank":50000},{"month":"2025-11","rank":10000},{"month":"2025-12","rank":10000}],"summary":"Top 10K worldwide; Top 1K in Italy; listed in 220 countries; 6-month trend: stable","origin":"https://checkout.stripe.com","dataset":{"release":"crux-202608","builtAt":"2026-10-03T10:46:48.688Z","dataMonth":"2026-08","countriesCovered":238,"sources":{"crux":{"name":"Chrome UX Report (CrUX) popularity rank, Google","license":"CC BY 4.0","url":"https://developer.chrome.com/docs/crux","lists":"https://github.com/zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: the domain is in no Chrome UX Report list (too little traffic for the lists, or a new site). Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"thisdomain-does-not-exist-xk29.com is not in the Chrome UX Report top lists (too little traffic for the lists, or a new site).","details":{"domain":"thisdomain-does-not-exist-xk29.com","dataMonth":"2026-08"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"trafficRank","summary":"Website traffic rank of one domain","description":"How popular a website is with Chrome users, from Google's public Chrome UX Report (CrUX) rank lists: the global popularity bucket over the last 12 months (Top 1K, 5K, 10K, 50K, 100K, 500K, 1M), the 6-month trend, the rank bucket in each of about 238 countries for the latest month, and the monthly history. These are rank buckets of origins with enough Chrome traffic, not visit counts or exact positions: a site outside the lists is not listed in any bucket. Data: Chrome UX Report, CC BY 4.0, refreshed monthly.\n\nThe same parameters as the GET form, sent as a JSON body.","tags":["Website Traffic Rank"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"A domain or website address: `stripe.com`, `https://www.stripe.com/pricing`, `shop.example.co.uk` (the parent domain is used when the exact name is not in the dataset, unless `exact=true`). Alias: `url`."},"countries":{"type":"string","description":"Comma-separated two-letter country codes (`us,gb,tw`; `uk` is accepted): the answer gets `rankIn` with the bucket in each, null when not listed there."},"maxCountries":{"type":"integer","default":10,"minimum":0,"maximum":300,"description":"How many countries to list in `countryRanks`, most relevant first (0 = all)."},"includeHistory":{"type":"boolean","default":true,"description":"Include the global bucket of each of the last 12 months in `globalHistory`."},"exact":{"type":"boolean","default":false,"description":"`true`: look up exactly this host (no fallback to the parent domain, e.g. `shop.example.com` does not become `example.com`)."}},"required":["domain"]}}}},"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true,"description":"Always true here."},"input":{"type":"string","description":"What you sent."},"domain":{"type":"string","description":"The domain that matched."},"found":{"type":"boolean","description":"false when the domain is in no Chrome list (single lookups answer 404 instead)."},"globalRank":{"type":"integer","description":"Chrome UX Report popularity bucket worldwide over the last 12 months: 1000, 5000, 10000, 50000, 100000, 500000 or 1000000 (a bucket, not an exact rank). null when not in the global top 1M.","nullable":true},"globalRankLabel":{"type":"string","description":"The bucket as a label, e.g. `Top 10K websites worldwide`.","nullable":true},"trend":{"type":"string","description":"Current bucket vs 6 months ago: `up`, `down`, `stable`, `new` (not listed 6 months ago) or `dropped` (no longer listed).","nullable":true,"enum":["up","down","stable","new","dropped"]},"globalRankSixMonthsAgo":{"type":"integer","description":"The bucket 6 months ago.","nullable":true},"monthsInGlobalTop1M":{"type":"integer","description":"Months (of the last 12) in the global top 1M."},"topCountry":{"type":"string","description":"Country where the site is most popular relative to the size of that country's list (ISO 3166-1 alpha-2, lower case).","nullable":true},"topCountryName":{"type":"string","description":"English name of `topCountry`.","nullable":true},"topCountryRank":{"type":"integer","description":"Bucket in `topCountry`.","nullable":true},"topCountryRankLabel":{"type":"string","description":"e.g. `Top 1K in Italy`.","nullable":true},"countryCount":{"type":"integer","description":"Number of countries (of about 238) whose Chrome list includes the site."},"rankIn":{"type":"object","properties":{"tw":{"type":"integer"},"jp":{"type":"integer"}},"description":"Only with `countries`: the bucket in each country you asked for (null when not listed there)."},"countryRanks":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"countryName":{"type":"string"},"rank":{"type":"integer"},"rankLabel":{"type":"string"}}},"description":"Country buckets, most relevant first (`maxCountries` of them; 0 = all)."},"globalHistory":{"type":"array","description":"Global bucket per month, oldest first (with `includeHistory=true`).","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"rank":{"type":"integer","nullable":true}}}},"summary":{"type":"string","description":"One plain-English line."},"origin":{"type":"string","description":"The origin (scheme and host) the Chrome list uses for the domain.","nullable":true},"dataset":{"type":"object","additionalProperties":true,"description":"Data release, month and sources (Chrome UX Report, CC BY 4.0).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"dataMonth":{"type":"string","description":"Month of the country lists, YYYY-MM."},"countriesCovered":{"type":"integer"},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"input":"stripe.com","domain":"stripe.com","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"stable","globalRankSixMonthsAgo":10000,"monthsInGlobalTop1M":12,"topCountry":"it","topCountryName":"Italy","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Italy","countryCount":220,"rankIn":{"tw":10000,"jp":50000},"countryRanks":[{"country":"it","countryName":"Italy","rank":1000,"rankLabel":"Top 1K"},{"country":"us","countryName":"United States","rank":5000,"rankLabel":"Top 5K"},{"country":"gb","countryName":"United Kingdom","rank":5000,"rankLabel":"Top 5K"},{"country":"fr","countryName":"France","rank":5000,"rankLabel":"Top 5K"}],"globalHistory":[{"month":"2025-09","rank":50000},{"month":"2025-10","rank":50000},{"month":"2025-11","rank":10000},{"month":"2025-12","rank":10000}],"summary":"Top 10K worldwide; Top 1K in Italy; listed in 220 countries; 6-month trend: stable","origin":"https://checkout.stripe.com","dataset":{"release":"crux-202608","builtAt":"2026-10-03T10:46:48.688Z","dataMonth":"2026-08","countriesCovered":238,"sources":{"crux":{"name":"Chrome UX Report (CrUX) popularity rank, Google","license":"CC BY 4.0","url":"https://developer.chrome.com/docs/crux","lists":"https://github.com/zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: the domain is in no Chrome UX Report list (too little traffic for the lists, or a new site). Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"thisdomain-does-not-exist-xk29.com is not in the Chrome UX Report top lists (too little traffic for the lists, or a new site).","details":{"domain":"thisdomain-does-not-exist-xk29.com","dataMonth":"2026-08"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/traffic-rank/batch":{"get":{"operationId":"trafficRankBatchGet","summary":"Website traffic rank of up to 50 domains (GET)","description":"The same answer for up to 50 domains in one call, in the order sent. A domain that is in no list or a line that is not a domain is reported in its own result (`found: false`, `note` or `error`); the call itself is still a success. Billed as one batch call.","tags":["Website Traffic Rank"],"parameters":[{"name":"domains","schema":{"type":"array","items":{"type":"string"},"maxItems":50},"style":"form","explode":false,"required":true,"description":"Up to 50 domains or website addresses: a JSON array in the POST body, or comma- or space-separated in the query string (GET). Duplicates are dropped. A line that is not a domain is reported in its own result (`error`), not as a failed call.","example":["stripe.com","apify.com","bbc.co.uk"],"in":"query"},{"name":"countries","schema":{"type":"string"},"description":"Comma-separated two-letter country codes (`us,gb,tw`; `uk` is accepted): the answer gets `rankIn` with the bucket in each, null when not listed there.","required":false,"example":"tw,jp","in":"query"},{"name":"maxCountries","schema":{"type":"integer","default":10,"minimum":0,"maximum":300},"description":"How many countries to list in `countryRanks`, most relevant first (0 = all).","required":false,"in":"query"},{"name":"includeHistory","schema":{"type":"boolean","default":true},"description":"Include the global bucket of each of the last 12 months in `globalHistory`.","required":false,"in":"query"},{"name":"exact","schema":{"type":"boolean","default":false},"description":"`true`: look up exactly this host (no fallback to the parent domain, e.g. `shop.example.com` does not become `example.com`).","required":false,"in":"query"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"count":{"type":"integer"},"found":{"type":"integer"},"notFound":{"type":"integer"},"invalid":{"type":"integer"},"dataset":{"type":"object","additionalProperties":true,"description":"Data release, month and sources (Chrome UX Report, CC BY 4.0).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"dataMonth":{"type":"string","description":"Month of the country lists, YYYY-MM."},"countriesCovered":{"type":"integer"},"sources":{"type":"object","additionalProperties":true}}},"results":{"type":"array","description":"One result per domain, in the order sent.","items":{"type":"object","properties":{"input":{"type":"string","description":"What you sent."},"domain":{"type":"string","description":"The domain that matched."},"found":{"type":"boolean","description":"false when the domain is in no Chrome list (single lookups answer 404 instead)."},"globalRank":{"type":"integer","description":"Chrome UX Report popularity bucket worldwide over the last 12 months: 1000, 5000, 10000, 50000, 100000, 500000 or 1000000 (a bucket, not an exact rank). null when not in the global top 1M.","nullable":true},"globalRankLabel":{"type":"string","description":"The bucket as a label, e.g. `Top 10K websites worldwide`.","nullable":true},"trend":{"type":"string","description":"Current bucket vs 6 months ago: `up`, `down`, `stable`, `new` (not listed 6 months ago) or `dropped` (no longer listed).","nullable":true,"enum":["up","down","stable","new","dropped"]},"globalRankSixMonthsAgo":{"type":"integer","description":"The bucket 6 months ago.","nullable":true},"monthsInGlobalTop1M":{"type":"integer","description":"Months (of the last 12) in the global top 1M."},"topCountry":{"type":"string","description":"Country where the site is most popular relative to the size of that country's list (ISO 3166-1 alpha-2, lower case).","nullable":true},"topCountryName":{"type":"string","description":"English name of `topCountry`.","nullable":true},"topCountryRank":{"type":"integer","description":"Bucket in `topCountry`.","nullable":true},"topCountryRankLabel":{"type":"string","description":"e.g. `Top 1K in Italy`.","nullable":true},"countryCount":{"type":"integer","description":"Number of countries (of about 238) whose Chrome list includes the site."},"rankIn":{"type":"object","properties":{"tw":{"type":"integer"},"jp":{"type":"integer"}},"description":"Only with `countries`: the bucket in each country you asked for (null when not listed there)."},"countryRanks":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"countryName":{"type":"string"},"rank":{"type":"integer"},"rankLabel":{"type":"string"}}},"description":"Country buckets, most relevant first (`maxCountries` of them; 0 = all)."},"globalHistory":{"type":"array","description":"Global bucket per month, oldest first (with `includeHistory=true`).","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"rank":{"type":"integer","nullable":true}}}},"summary":{"type":"string","description":"One plain-English line."},"origin":{"type":"string","description":"The origin (scheme and host) the Chrome list uses for the domain.","nullable":true},"error":{"type":"string","description":"Only for a line that is not a domain or website address."},"note":{"type":"string","description":"Only when found is false."}}}}}},"example":{"success":true,"count":5,"found":4,"notFound":1,"invalid":0,"dataset":{"release":"crux-202608","builtAt":"2026-10-03T10:46:48.688Z","dataMonth":"2026-08","countriesCovered":238,"sources":{"crux":{"name":"Chrome UX Report (CrUX) popularity rank, Google","license":"CC BY 4.0","url":"https://developer.chrome.com/docs/crux","lists":"https://github.com/zakird/crux-top-lists"}}},"results":[{"input":"stripe.com","domain":"stripe.com","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"stable","globalRankSixMonthsAgo":10000,"monthsInGlobalTop1M":12,"topCountry":"it","topCountryName":"Italy","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Italy","countryCount":220,"countryRanks":[{"country":"it","countryName":"Italy","rank":1000,"rankLabel":"Top 1K"},{"country":"us","countryName":"United States","rank":5000,"rankLabel":"Top 5K"}],"summary":"Top 10K worldwide; Top 1K in Italy; listed in 220 countries; 6-month trend: stable","origin":"https://checkout.stripe.com"},{"input":"apify.com","domain":"apify.com","found":true,"globalRank":100000,"globalRankLabel":"Top 100K websites worldwide","trend":"up","globalRankSixMonthsAgo":500000,"monthsInGlobalTop1M":12,"topCountry":"de","topCountryName":"Germany","topCountryRank":50000,"topCountryRankLabel":"Top 50K in Germany","countryCount":135,"countryRanks":[{"country":"de","countryName":"Germany","rank":50000,"rankLabel":"Top 50K"},{"country":"in","countryName":"India","rank":50000,"rankLabel":"Top 50K"}],"summary":"Top 100K worldwide; Top 50K in Germany; listed in 135 countries; 6-month trend: rising","origin":"https://apify.com"},{"input":"bbc.co.uk","domain":"bbc.co.uk","found":true,"globalRank":1000,"globalRankLabel":"Top 1K websites worldwide","trend":"stable","globalRankSixMonthsAgo":1000,"monthsInGlobalTop1M":12,"topCountry":"gb","topCountryName":"United Kingdom","topCountryRank":1000,"topCountryRankLabel":"Top 1K in United Kingdom","countryCount":223,"countryRanks":[{"country":"gb","countryName":"United Kingdom","rank":1000,"rankLabel":"Top 1K"},{"country":"ca","countryName":"Canada","rank":1000,"rankLabel":"Top 1K"}],"summary":"Top 1K worldwide; Top 1K in United Kingdom; listed in 223 countries; 6-month trend: stable","origin":"https://www.bbc.co.uk"},{"input":"ruten.com.tw","domain":"ruten.com.tw","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"down","globalRankSixMonthsAgo":5000,"monthsInGlobalTop1M":12,"topCountry":"tw","topCountryName":"Taiwan","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Taiwan","countryCount":40,"countryRanks":[{"country":"tw","countryName":"Taiwan","rank":1000,"rankLabel":"Top 1K"},{"country":"hk","countryName":"Hong Kong SAR China","rank":5000,"rankLabel":"Top 5K"}],"summary":"Top 10K worldwide; Top 1K in Taiwan; listed in 40 countries; 6-month trend: falling","origin":"https://www.ruten.com.tw"}]}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"trafficRankBatch","summary":"Website traffic rank of up to 50 domains","description":"The same answer for up to 50 domains in one call, in the order sent. A domain that is in no list or a line that is not a domain is reported in its own result (`found: false`, `note` or `error`); the call itself is still a success. Billed as one batch call.\n\nThe same parameters as the GET form, sent as a JSON body.","tags":["Website Traffic Rank"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Up to 50 domains or website addresses: a JSON array in the POST body, or comma- or space-separated in the query string (GET). Duplicates are dropped. A line that is not a domain is reported in its own result (`error`), not as a failed call."},"countries":{"type":"string","description":"Comma-separated two-letter country codes (`us,gb,tw`; `uk` is accepted): the answer gets `rankIn` with the bucket in each, null when not listed there."},"maxCountries":{"type":"integer","default":10,"minimum":0,"maximum":300,"description":"How many countries to list in `countryRanks`, most relevant first (0 = all)."},"includeHistory":{"type":"boolean","default":true,"description":"Include the global bucket of each of the last 12 months in `globalHistory`."},"exact":{"type":"boolean","default":false,"description":"`true`: look up exactly this host (no fallback to the parent domain, e.g. `shop.example.com` does not become `example.com`)."}},"required":["domains"]}}}},"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"count":{"type":"integer"},"found":{"type":"integer"},"notFound":{"type":"integer"},"invalid":{"type":"integer"},"dataset":{"type":"object","additionalProperties":true,"description":"Data release, month and sources (Chrome UX Report, CC BY 4.0).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"dataMonth":{"type":"string","description":"Month of the country lists, YYYY-MM."},"countriesCovered":{"type":"integer"},"sources":{"type":"object","additionalProperties":true}}},"results":{"type":"array","description":"One result per domain, in the order sent.","items":{"type":"object","properties":{"input":{"type":"string","description":"What you sent."},"domain":{"type":"string","description":"The domain that matched."},"found":{"type":"boolean","description":"false when the domain is in no Chrome list (single lookups answer 404 instead)."},"globalRank":{"type":"integer","description":"Chrome UX Report popularity bucket worldwide over the last 12 months: 1000, 5000, 10000, 50000, 100000, 500000 or 1000000 (a bucket, not an exact rank). null when not in the global top 1M.","nullable":true},"globalRankLabel":{"type":"string","description":"The bucket as a label, e.g. `Top 10K websites worldwide`.","nullable":true},"trend":{"type":"string","description":"Current bucket vs 6 months ago: `up`, `down`, `stable`, `new` (not listed 6 months ago) or `dropped` (no longer listed).","nullable":true,"enum":["up","down","stable","new","dropped"]},"globalRankSixMonthsAgo":{"type":"integer","description":"The bucket 6 months ago.","nullable":true},"monthsInGlobalTop1M":{"type":"integer","description":"Months (of the last 12) in the global top 1M."},"topCountry":{"type":"string","description":"Country where the site is most popular relative to the size of that country's list (ISO 3166-1 alpha-2, lower case).","nullable":true},"topCountryName":{"type":"string","description":"English name of `topCountry`.","nullable":true},"topCountryRank":{"type":"integer","description":"Bucket in `topCountry`.","nullable":true},"topCountryRankLabel":{"type":"string","description":"e.g. `Top 1K in Italy`.","nullable":true},"countryCount":{"type":"integer","description":"Number of countries (of about 238) whose Chrome list includes the site."},"rankIn":{"type":"object","properties":{"tw":{"type":"integer"},"jp":{"type":"integer"}},"description":"Only with `countries`: the bucket in each country you asked for (null when not listed there)."},"countryRanks":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"countryName":{"type":"string"},"rank":{"type":"integer"},"rankLabel":{"type":"string"}}},"description":"Country buckets, most relevant first (`maxCountries` of them; 0 = all)."},"globalHistory":{"type":"array","description":"Global bucket per month, oldest first (with `includeHistory=true`).","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"rank":{"type":"integer","nullable":true}}}},"summary":{"type":"string","description":"One plain-English line."},"origin":{"type":"string","description":"The origin (scheme and host) the Chrome list uses for the domain.","nullable":true},"error":{"type":"string","description":"Only for a line that is not a domain or website address."},"note":{"type":"string","description":"Only when found is false."}}}}}},"example":{"success":true,"count":5,"found":4,"notFound":1,"invalid":0,"dataset":{"release":"crux-202608","builtAt":"2026-10-03T10:46:48.688Z","dataMonth":"2026-08","countriesCovered":238,"sources":{"crux":{"name":"Chrome UX Report (CrUX) popularity rank, Google","license":"CC BY 4.0","url":"https://developer.chrome.com/docs/crux","lists":"https://github.com/zakird/crux-top-lists"}}},"results":[{"input":"stripe.com","domain":"stripe.com","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"stable","globalRankSixMonthsAgo":10000,"monthsInGlobalTop1M":12,"topCountry":"it","topCountryName":"Italy","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Italy","countryCount":220,"countryRanks":[{"country":"it","countryName":"Italy","rank":1000,"rankLabel":"Top 1K"},{"country":"us","countryName":"United States","rank":5000,"rankLabel":"Top 5K"}],"summary":"Top 10K worldwide; Top 1K in Italy; listed in 220 countries; 6-month trend: stable","origin":"https://checkout.stripe.com"},{"input":"apify.com","domain":"apify.com","found":true,"globalRank":100000,"globalRankLabel":"Top 100K websites worldwide","trend":"up","globalRankSixMonthsAgo":500000,"monthsInGlobalTop1M":12,"topCountry":"de","topCountryName":"Germany","topCountryRank":50000,"topCountryRankLabel":"Top 50K in Germany","countryCount":135,"countryRanks":[{"country":"de","countryName":"Germany","rank":50000,"rankLabel":"Top 50K"},{"country":"in","countryName":"India","rank":50000,"rankLabel":"Top 50K"}],"summary":"Top 100K worldwide; Top 50K in Germany; listed in 135 countries; 6-month trend: rising","origin":"https://apify.com"},{"input":"bbc.co.uk","domain":"bbc.co.uk","found":true,"globalRank":1000,"globalRankLabel":"Top 1K websites worldwide","trend":"stable","globalRankSixMonthsAgo":1000,"monthsInGlobalTop1M":12,"topCountry":"gb","topCountryName":"United Kingdom","topCountryRank":1000,"topCountryRankLabel":"Top 1K in United Kingdom","countryCount":223,"countryRanks":[{"country":"gb","countryName":"United Kingdom","rank":1000,"rankLabel":"Top 1K"},{"country":"ca","countryName":"Canada","rank":1000,"rankLabel":"Top 1K"}],"summary":"Top 1K worldwide; Top 1K in United Kingdom; listed in 223 countries; 6-month trend: stable","origin":"https://www.bbc.co.uk"},{"input":"ruten.com.tw","domain":"ruten.com.tw","found":true,"globalRank":10000,"globalRankLabel":"Top 10K websites worldwide","trend":"down","globalRankSixMonthsAgo":5000,"monthsInGlobalTop1M":12,"topCountry":"tw","topCountryName":"Taiwan","topCountryRank":1000,"topCountryRankLabel":"Top 1K in Taiwan","countryCount":40,"countryRanks":[{"country":"tw","countryName":"Taiwan","rank":1000,"rankLabel":"Top 1K"},{"country":"hk","countryName":"Hong Kong SAR China","rank":5000,"rankLabel":"Top 5K"}],"summary":"Top 10K worldwide; Top 1K in Taiwan; listed in 40 countries; 6-month trend: falling","origin":"https://www.ruten.com.tw"}]}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_configured","unauthorized","not_found","method_not_allowed","invalid_request","rate_limited","url_not_allowed","target_blocked","target_unreachable","target_error","unsupported_content","too_large","timeout","upstream_error","board_not_found","app_not_found","robots_disallowed","browser_busy","region_unavailable","no_region_delivered","location_not_found","domain_not_found"]},"message":{"type":"string"},"retryable":{"type":"boolean","description":"true for rate_limited, timeout, upstream_error and browser_busy; false for other errors."},"retryAfterSeconds":{"type":"integer","description":"Seconds to wait before retrying, when a numeric Retry-After header is present."},"details":{"type":"object","additionalProperties":true}}}}}}}}