Home / Docs / API reference / count_sites
count_sites
Counts the sites that match a filter, split by popularity bucket, and says what the full list would cost in full_list_credits. Free, and on REST it works without a key, so call it before search_sites to size and price a list.
GET/v1/countsFree
Inputs
The site filters, nothing else.
Request
curl "https://api.whichsitesuse.com/v1/counts?technologies=shopify&max_rank=100000&cwv=lcp:fail"
Over MCP, call the tool with these arguments:
{
"technologies": ["shopify"],
"max_rank": 100000,
"cwv": { "lcp": "fail" }
}
Response
A real response from the 2026-11-01 crawl.
{
"data": {
"total": 367,
"by_rank_bucket": [
{ "rank_bucket": 5000, "sites": 2 },
{ "rank_bucket": 10000, "sites": 13 },
{ "rank_bucket": 50000, "sites": 136 },
{ "rank_bucket": 100000, "sites": 216 }
],
"full_list_credits": 367
},
"meta": {
"crawl_date": "2026-11-01",
"credits_used": 0,
"credits_remaining": null,
"attribution": "Technology data from HTTP Archive (httparchive.org), detected with its open-source Wappalyzer fork. Core Web Vitals from the Chrome UX Report."
}
}
Buckets run from most popular to least, and null (unknown rank) comes last. full_list_credits equals total, because each site in a list costs one credit.