Home / Docs / API reference / search_sites
search_sites
Lists the sites that match a filter, best-ranked first, with the technologies that matched (versions and first and last seen dates) and a Core Web Vitals summary for each. Costs 1 credit per site returned.
GET/v1/sites1 credit per site
Inputs
The site filters, plus:
| Field | Type and limits | Notes |
|---|---|---|
| limit | integer, 1 to 1000, default 100 | Most sites to return in this call. |
| max_credits | integer, 0 or more | Most credits this call may spend. The call returns fewer sites rather than spend more. |
| cursor | string, 1 to 1000 characters | next_cursor from the previous page, unchanged. |
A page holds the smallest of limit, your balance, max_credits, what's left under the key's monthly cap, and 100 for accounts that haven't paid yet. If that comes to zero you get an insufficient_credits error with checkout links instead of an empty page, unless you passed max_credits: 0, which returns no sites, costs nothing and hands back the same cursor.
Request
curl "https://api.whichsitesuse.com/v1/sites?technologies=shopify&max_rank=500000&tld=com&limit=100&max_credits=100" \
-H "Authorization: Bearer $WSU_API_KEY"
Over MCP, call the tool with these arguments:
{
"technologies": ["shopify"],
"max_rank": 500000,
"tld": ["com"],
"limit": 100,
"max_credits": 100
}
Response
One site from this list, with values from the 2026-11-01 crawl. The rest of the page is left out.
{
"data": {
"sites": [
...
{
"domain": "allbirds.com",
"root_url": "https://www.allbirds.com/",
"rank_bucket": 500000,
"tld": "com",
"technologies": [
{
"name": "Shopify",
"slug": "shopify",
"version": null,
"first_seen": "2026-11-01",
"last_seen": "2026-11-01",
"confidence": 1
}
],
"cwv": {
"device": "mobile",
"lcp": { "p75": 1900, "pass": true },
"inp": { "p75": 175, "pass": true },
"cls": { "p75": 0, "pass": true }
},
"source": "httparchive"
},
...
],
"next_cursor": "..."
},
"meta": { "crawl_date": "2026-11-01", "credits_used": 100, "credits_remaining": ..., ... }
}
Sites are ordered by popularity bucket, then by domain. next_cursor is null on the last page. LCP and INP are in milliseconds and CLS has no unit; pass is null when the site has no field data.