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:

FieldType and limitsNotes
limitinteger, 1 to 1000, default 100Most sites to return in this call.
max_creditsinteger, 0 or moreMost credits this call may spend. The call returns fewer sites rather than spend more.
cursorstring, 1 to 1000 charactersnext_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.