APIs

Domain Intelligence API

View as markdown Open in ChatGPT Open in Claude

What it is

GET /v3/domain-intelligence?domain=… answers two questions at once: which legal entity operates this domain, and what is this domain for. The entity half is the same identity core as resolution (a siq_ ID anchored to a registration, or a candidate); the domain half is everything we know about the domain itself.

Input: a bare domain, a full URL, or an email address. All normalize to the root domain.
Output: data.entity (or data.candidate) plus data.domain_intelligence.
Timing: a domain we already hold answers in seconds. A new one returns status: "building" and completes in a few minutes; poll, or pass webhook_url and get the result delivered.

The company name on a website is not the legal entity that operates it. office.com is Microsoft Corporation. The entity half is what makes that determination.

Status lifecycle

Top-level status:

building: analysis and entity resolution in progress; data is null
complete: both halves are ready
refreshing: current data served while a background refresh runs
failed: analysis could not complete

Request

curl 'https://api.savvyiq.ai/v3/domain-intelligence?domain=datadoghq.com' \
  -H 'apikey: YOUR_API_KEY'

Also accepts POST with a JSON body: {"domain": "datadoghq.com"}.

Optional: webhook_url and custom_id, the same per-call delivery as resolution. See Webhooks.

Example response

Datadog, verbatim from the reference capture, with the two descriptions shortened.

{
  "domain": "datadoghq.com",
  "status": "complete",
  "data": {
    "status": "matched",
    "confidence": 98,
    "type": "business",
    "subtype": "incorporated_entity",
    "entity": {
      "id": "siq_33GtdRpeJrG8n7orm8iI2",
      "display_name": "Datadog",
      "legal_name": "DATADOG, INC.",
      "status": "active",
      "description": "Datadog is a technology company specializing in monitoring and analytics for cloud applications ...",
      "website": "https://www.datadoghq.com/",
      "headquarters": {
        "address": { "street_address": "620 8th Ave 45th Floor", "city": "New York", "state_code": "NY", "postal_code": "10018", "country_code": "US" }
      },
      "primary_legal_entity": { "id": "le_33GtddNjSzLpgddO2Yy6y", "jurisdiction": "US-DE", "state_code": "DE", "country_code": "US" },
      "identifiers": [ { "type": "sec_cik", "value": "1561550" } ],
      "matching_branch": null
    },
    "candidate": null,
    "factors": [
      { "code": "website_official_status", "type": "strength", "impact": "Confirms this is the entity's official website.", "description": "The domain 'datadoghq.com' clearly functions as the official website for Datadog." },
      { "code": "legal_entity_confirmed_on_website", "type": "strength", "impact": "Confirms the legal entity operating this domain.", "description": "The legal entity 'DATADOG, INC.' is identified and confirmed within the domain's legal information." },
      { "code": "domain_content_matches_entity", "type": "strength", "impact": "Confirms this is the entity's official domain.", "description": "Domain content, branding, and services on 'datadoghq.com' strongly align with Datadog's operations." },
      { "code": "consistent_entity_references", "type": "strength", "impact": "Eliminates ambiguity about domain ownership.", "description": "Multiple pages across 'datadoghq.com' consistently reference Datadog and its corporate identity." }
    ],
    "actions": [],
    "domain_intelligence": {
      "domain": "datadoghq.com",
      "url": "https://www.datadoghq.com/",
      "domain_aliases": [],
      "description": "Datadog, Inc. is an American technology company that provides a cloud monitoring and analytics platform ...",
      "tranco_rank": 739,
      "website_status": {
        "status": 200,
        "is_resolvable": true,
        "is_webserver_responsive": true,
        "has_content": true,
        "failure_reason": null,
        "last_checked": "2026-06-28T23:17:06.745Z"
      },
      "social_profiles": {
        "linkedin": { "handle": null },
        "facebook": { "handle": null },
        "crunchbase": { "handle": null },
        "twitter": { "handle": null }
      },
      "classification": {
        "sector": "Technology",
        "industry": "Software",
        "sub_industry": "Enterprise Software",
        "market_segments": [ "b2b" ],
        "revenue_models": [ "subscription" ],
        "products_services": [ "Infrastructure Monitoring", "Application Performance Monitoring (APM)", "Log Management", "Security Monitoring", "Digital Experience Monitoring (DEM)", "Cloud Cost Management", "AI-powered insights" ],
        "business_tags": [ "Cloud Monitoring", "Observability Platform", "DevOps Tools", "IT Operations Management", "SaaS", "Data Analytics", "Cybersecurity", "Performance Management", "Cloud Computing", "Software Development" ]
      },
      "domain_context": {
        "domain_type": "corporate_website",
        "domain_relationship": "direct_owner",
        "domain_purpose": "The primary online presence for Datadog, Inc., used for marketing products, providing customer support, and hosting company information.",
        "business_relevance": "datadoghq.com is the official corporate website and a critical channel for Datadog to engage with customers, showcase its platform, and conduct its core business operations as a software provider."
      },
      "is_disposable_email_provider": false,
      "industry": {
        "schemes": {
          "naics_2022": [
            { "code": "513210", "label": "Software Publishers", "is_primary": true, "confidence": 95 },
            { "code": "51", "label": "Information", "is_primary": false, "confidence": 90 },
            { "code": "541511", "label": "Custom Computer Programming Services", "is_primary": false, "confidence": 80 }
          ]
        }
      }
    }
  },
  "message": null,
  "metadata": { "last_updated": "2026-08-10T01:49:37.992Z", "processing_started_at": null, "estimated_completion": null },
  "request_id": "req_344trDC0nwk1zbUrYegyQ"
}

Reading the result

data.entity is the identity core only: name, status, headquarters, primary_legal_entity, identifiers. For firmographics and the full industry set, read /v3/entities/{id} with data.entity.id.
data.candidate is populated instead when we could not commit to a registration: a parked domain, a sole trader, a type we do not record yet. It has no ID. See Entities and candidates.
data.confidence and data.factors explain the entity match. Note the score is named confidence on this surface and match_confidence on resolution.
data.domain_intelligence describes the domain, not the company: domain_context.domain_type says what kind of site it is (corporate_website, parked_domain, email_domain, …) and domain_relationship how the entity relates to it (direct_owner, parent_company, service_provider, …). classification and industry here are domain-scoped: a product site classifies as the product, not the whole company.
identifiers[] on this surface is served as stored (sec_cik, unpadded, no jurisdiction); the resolution and record surfaces canonicalize (cik, zero-padded). Treat the two as the per-surface difference they currently are.

Every enum is listed in Codes & enums.

Common integration

Submit the domain, URL or email.
If status is building, poll or wait for the webhook.
If data.entity is present, store data.entity.id.
Read the full record from /v3/entities/{id} when you need more than identity.

Reference

GET /v3/domain-intelligence

The v1 endpoint (/v1/domain-intelligence) keeps working; its reference is the 2026-07-30 edition.