Home / Docs / API reference / lookup_domain

lookup_domain

Returns one domain's full stack, grouped by category, with versions and first and last seen dates, plus its popularity bucket and Core Web Vitals on mobile and desktop. Costs 2 credits. A domain that isn't in the crawl comes back as covered: false and costs nothing.

GET/v1/domains/:domain2 credits

Inputs

FieldType and limitsNotes
domainstring, 1 to 2048 characters, requiredA domain or URL. The scheme, path, port and a leading www. are ignored, so https://www.example.com/pricing looks up example.com.

Request

curl "https://api.whichsitesuse.com/v1/domains/allbirds.com" \
  -H "Authorization: Bearer $WSU_API_KEY"

Over MCP, call the tool with these arguments:

{ "domain": "allbirds.com" }

Response

A real response from the 2026-11-01 crawl, trimmed to four of its 19 categories.

{
  "data": {
    "covered": true,
    "domain": "allbirds.com",
    "root_url": "https://www.allbirds.com/",
    "rank_bucket": 500000,
    "tld": "com",
    "stack": [
      {
        "category": "Analytics",
        "technologies": [
          {
            "name": "Facebook Pixel",
            "slug": "facebook-pixel",
            "version": "2.9.439",
            "categories": ["Analytics"],
            "first_seen": "2026-11-01",
            "last_seen": "2026-11-01",
            "confidence": 1
          },
          ...
        ]
      },
      {
        "category": "CMS",
        "technologies": [
          {
            "name": "Shopify",
            "slug": "shopify",
            "version": null,
            "categories": ["CMS", "Ecommerce"],
            "first_seen": "2026-11-01",
            "last_seen": "2026-11-01",
            "confidence": 1
          }
        ]
      },
      {
        "category": "JavaScript libraries",
        "technologies": [
          {
            "name": "core-js",
            "slug": "core-js",
            "version": "3.37.0",
            "categories": ["JavaScript libraries"],
            "first_seen": "2026-11-01",
            "last_seen": "2026-11-01",
            "confidence": 1
          },
          ...
        ]
      },
      {
        "category": "Payment processors",
        "technologies": [
          { "name": "Apple Pay", "slug": "apple-pay", ... },
          { "name": "PayPal", "slug": "paypal", ... },
          { "name": "Shop Pay", "slug": "shop-pay", ... }
        ]
      },
      ...
    ],
    "cwv": {
      "mobile": {
        "device": "mobile",
        "lcp": { "p75": 1900, "pass": true },
        "inp": { "p75": 175, "pass": true },
        "cls": { "p75": 0, "pass": true }
      },
      "desktop": {
        "device": "desktop",
        "lcp": { "p75": 1700, "pass": true },
        "inp": { "p75": 125, "pass": true },
        "cls": { "p75": 0, "pass": true }
      }
    },
    "last_crawl_date": "2026-11-01",
    "source": "httparchive"
  },
  "meta": { "crawl_date": "2026-11-01", "credits_used": 2, "credits_remaining": ..., ... }
}

When the domain isn't covered:

{
  "data": {
    "covered": false,
    "domain": "discoshrimp.lol",
    "message": "discoshrimp.lol isn't in this month's crawl. HTTP Archive covers sites with real Chrome traffic (from the Chrome UX Report), so small, new or private sites are often missing. No credits were charged."
  },
  "meta": { "crawl_date": "2026-11-01", "credits_used": 0, ... }
}

Each technology is grouped under its first category, and its categories field lists all of them. Something that isn't a domain, like a bare word, is an invalid_input error.