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.