Sockt API and MCP tools

Look up domains, search by technology and export lists from your own code with a Sockt API key, or let a Raq.com agent do the same work through MCP. The web app, API and MCP draw on one shared quota.

Join the waitlist API lookups by plan

Authentication

Make an API key on your Sockt plan page in Raq.com and send it as a bearer token, or in an X-API-Key header. A key is yours, works only for the account it was made in and uses that account's Sockt plan and limits. Keys can start exports unless you turn that off when you make one.

The base URL is https://raq.com/api/v1/sockt. Requests and responses are JSON: results come back under data, and errors as error with a code and a message. Domains can be typed with or without www., a path or a scheme: Sockt reduces them to the registered domain.

Company details are AI estimates and are labelled as estimates. The evidence behind each detection is shown only in the Sockt app in Raq.com, never through the API.

Example with demo data

curl https://raq.com/api/v1/sockt/domains/northfield-coffee.co.uk \
  -H "Authorization: Bearer $RAQ_TOKEN"

{
  "data": {
    "domain": "northfield-coffee.co.uk",
    "rank": 48210,
    "analysed_at": "2026-09-16T08:12:44Z",
    "source": "commoncrawl:CC-MAIN-2026-39",
    "technologies": [
      {
        "slug": "shopify",
        "name": "Shopify",
        "categories": [{ "slug": "ecommerce", "name": "Ecommerce" }],
        "version": null,
        "confidence": 100,
        "method": "script",
        "first_seen": "2026-09-16",
        "last_seen": "2026-09-16"
      }
    ]
  }
}

curl https://raq.com/api/v1/sockt/search \
  -H "Authorization: Bearer $RAQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"filter": {"all": ["shopify", "stripe"], "none": ["woocommerce"], "countries": ["GB"]}, "limit": 50}'

{
  "data": {
    "total": 4,
    "rows": [
      { "domain": "northfield-coffee.co.uk", "rank": 48210 },
      { "domain": "copperleaf-tea.co.uk", "rank": 91377 },
      { "domain": "millrace-bikes.co.uk", "rank": 310554 },
      { "domain": "saltmarsh-supply.co.uk", "rank": null }
    ],
    "next_cursor": null,
    "limited": false,
    "new_domains": 4
  }
}

// A Raq.com agent calling a Sockt tool over MCP
{
  "tool": "sockt_search_domains",
  "arguments": {
    "filter": {
      "all": ["shopify", "stripe"],
      "countries": ["GB"]
    },
    "limit": 50
  }
}

Endpoints

Paths are relative to https://raq.com/api/v1/sockt
Request	What it returns	Uses
`GET /domains/{domain}`	Technologies for one domain with categories, versions, first and last seen dates, method and confidence, plus company estimates, DNS and social links where known.	One API lookup
`POST /lookup`	Up to 1,000 domains in one call. Domains Sockt has not analysed come back in missing, and unreadable input in invalid.	One API lookup per domain found
`POST /search`	Domains matching technology, category, country, TLD, industry and rank filters, top ranked first, up to 100 a page with a cursor.	Exported domains, each website counted once a month
`POST /count`	How many domains match a filter, split by TLD and country.	Free
`GET /technologies`	Technology slugs and names for filters, searchable by name and category.	Free
`GET /technologies/{slug}`	One technology: its categories, how many domains use it, the top sites and its split by TLD.	Free
`GET /usage`	Your plan and this month's exported domains, API lookups and monitored domains against its limits.	Free
`GET /lists`	Saved Sockt lists you can see, with their filters and last counts.	Free
`POST /exports`	Starts a CSV export of a filter or a saved list and returns 202 with the export. Needs a key that can start exports.	Exported domains, each website counted once a month
`GET /exports/{export}`	An export's status, with a short-lived download link once it is ready.	Free

MCP tools

Raq.com agents, and any MCP client connected to your Raq.com account, can call these tools. They use the same quota as the web app and API, and an agent can pass the results to Raq.com CRM or a task.

sockt_lookup_domain: Technologies for one domain, or up to 1,000 at once
sockt_search_domains: Domains that match technology, country and TLD filters
sockt_count_domains: How many domains match a filter before you export
sockt_list_technologies: Find the slug for a technology by name
sockt_list_saved_lists: Saved Sockt lists and their filters
sockt_start_export: Start a CSV export of a filter or saved list
sockt_get_export: Check an export and get its download link
sockt_get_usage: Allowances used this month and plan limits

Limits and errors

Paid plans have a monthly allowance of API lookups and exported domains. A website returned by a search or an export counts once a month, however often you fetch it. When an allowance runs out, requests that need it return HTTP 429 with the code limit_reached, the allowance, its limit and when it resets. Counts, the technology catalogue, usage, lists and export status are free on every plan.

Lookups, searches and exports have a lower per-minute limit than the free reads. Too many requests in a short time return HTTP 429 with a Retry-After header. A website whose owner asked to be removed returns 410 with the code removed.

Sockt is part of Raq.com

Sockt opens to everyone soon, with sign-up and billing through Raq.com. Lists you build in Sockt will go into Raq.com CRM, and Raq.com agents will use Sockt through MCP. Join the waitlist and we will email you when it opens.

Join the waitlist