# Resolve a domain

`GET /v3/domain-intelligence`

> Tag: Domain Intelligence

Resolves a domain to the business behind it and describes the domain itself: what kind of
site it is, how it relates to that business, its industry breakdown, reachability, and
social profiles.

Synchronous, and **always returns `200`**. Check the top-level `status`. `complete` means
`data` is populated. `building` and `pending` mean research is still running and `data` is
`null`, so call again shortly.

## Request

### Query parameters

- `domain` (string, required) — A domain, a full URL, or an email address. All are normalized to the root domain, so `https://www.datadoghq.com/pricing`, `datadoghq.com` and `jane@datadoghq.com` are equivalent.

### Example request

```bash
curl --request GET \
  --url 'https://api.savvyiq.ai/v3/domain-intelligence?domain=value' \
  --header 'apikey: YOUR_API_KEY'
```

## Responses

### 200 — Always returned, including while research is still running. Check `status`.

- `domain` (string) — The normalized root domain.
- `status` (string (enum)) — `complete` means `data` is populated. `building` and `pending` mean research is still running and `data` is `null`.
- `message` (string)
- `request_id` (string)
- `metadata` (object)
  - `last_updated` (string <date-time>)
  - `processing_started_at` (string <date-time>)
  - `estimated_completion` (string <date-time>)
- `data` (object) — Null until `status` is `complete`.
  - `status` (string (enum))
  - `confidence` (integer)
  - `type` (string)
  - `subtype` (string)
  - `entity` (object)
    - `id` (string)
    - `display_name` (string) — The brand or common name.
    - `legal_name` (string) — The registered name, as it appears on the government record.
    - `status` (string (enum))
    - `description` (string)
    - `website` (string)
    - `headquarters` (object) — The headquarters address, always as the nested `address` object — there are no flat alias fields. Every key below is always present; unknown values are `null` rather than omitted, so the key set is stable across responses and endpoints.
      - `address` (object)
    - `primary_legal_entity` (object) — The government registration that anchors this entity.
      - `id` (string)
      - `jurisdiction` (string)
      - `country_code` (string)
      - `state_code` (string)
      - `registration_authority` (object) — The government register this entity is recorded in.
    - `identifiers` (array<object>) — Typed external identifiers, in a stable order.
      - `type` (string (enum))
      - `value` (string) — Canonicalized for its type on the resolution and record endpoints. See [Codes & enums](#codes-enums).
      - `jurisdiction` (string) — ISO jurisdiction, where the identifier type is jurisdictional. Absent entirely on `/v3/domain-intelligence`.
    - `matching_branch` (object) — Set when the query matched a specific branch or foreign registration rather than the entity's home registration.
  - `candidate` (object) — Our best hypothesis when an entity could not be confirmed. A response populates `entity` or `candidate`, never both.
    - `name` (string)
    - `legal_name` (string)
    - `jurisdiction` (string)
    - `status` (string)
    - `description` (string)
    - `primary_address` (object)
      - `full_address` (string)
      - `state_code` (string)
      - `country_code` (string)
  - `factors` (array<object>)
    - `code` (string) — Stable code. See [Codes & enums](#codes-enums).
    - `type` (string (enum))
    - `description` (string)
    - `impact` (string)
  - `actions` (array<object>)
    - `code` (string)
    - `description` (string)
  - `domain_intelligence` (object) — What we know about the domain itself, as distinct from the company behind it.
    - `domain` (string)
    - `url` (string)
    - `domain_aliases` (array<string>)
    - `description` (string)
    - `tranco_rank` (integer) — Global traffic rank. Lower is bigger.
    - `website_status` (object) — Reachability of the domain when we last checked it.
      - `status` (integer) — HTTP status code observed.
      - `is_resolvable` (boolean)
      - `is_webserver_responsive` (boolean)
      - `has_content` (boolean)
      - `failure_reason` (string)
      - `last_checked` (string <date-time>)
    - `domain_context` (object) — What this domain is, and how it relates to the business behind it.
      - `domain_type` (string (enum))
      - `domain_relationship` (string (enum))
      - `domain_purpose` (string)
      - `business_relevance` (string)
    - `is_disposable_email_provider` (boolean)
    - `industry` (object) — Industry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.
      - `schemes` (object)
    - `classification` (object) — Scoped to this domain's observable motion, which can legitimately differ from the whole company's. Compare with `classification` on `/v3/entities/{id}`.
      - `sector` (string)
      - `industry` (string)
      - `sub_industry` (string)
      - `business_tags` (array<string>)
      - `market_segments` (array<string (enum)>)
      - `revenue_models` (array<string>)
      - `products_services` (array<string>)
    - `social_profiles` (object) — The accounts this site links to. Same `{handle}` shape as the entity record, so one parser reads both. The entity record's set is the entity's best-known handles; this set is what the domain itself advertises, and the two can differ.
      - `linkedin` (object)
      - `facebook` (object)
      - `crunchbase` (object)
      - `twitter` (object)
  - `redirect_info` (object) — Present only when the requested domain redirected elsewhere.
    - `is_redirect` (boolean)
    - `original_domain` (string)
    - `final_domain` (string)
    - `redirect_status_code` (integer)
    - `redirect_type` (string)

```json
{
  "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, infrastructure, and data. They offer a comprehensive observability platform that integrates infrastructure monitoring, application performance management (APM), log management, and security solutions.\n\nDatadog's platform helps organizations ensure the performance, availability, and security of their cloud environments, enabling DevOps teams to prevent downtime, resolve issues, and enhance user experience. Headquartered in New York City, Datadog serves a global customer base with AI-powered features and a wide range of developer tools.",
      "website": "https://www.datadoghq.com/",
      "headquarters": {
        "address": {
          "street_address": "620 8th Ave 45th Floor",
          "street_number": null,
          "sub_premise": null,
          "city": "New York",
          "state": "New York",
          "state_code": "NY",
          "postal_code": "10018",
          "country": "United States",
          "country_code": "US",
          "formatted_address": "620 8th Ave 45th Floor, New York, New York 10018, United States"
        }
      },
      "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 for cloud applications. The company specializes in software for infrastructure monitoring, application performance monitoring, log management, security monitoring, and digital experience monitoring. Datadog's platform helps businesses gain visibility into their systems, improve performance, enhance security, and optimize costs across various cloud services and technologies. It serves diverse industries including financial services, healthcare, retail, and technology.",
      "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"
}
```

### 400 — Invalid or missing parameters.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "bad_request",
    "message": "Name is required"
  }
}
```

### 401 — Missing or invalid API key.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```

### 402 — Credit balance exhausted.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "insufficient_credits",
    "message": "Insufficient credits"
  }
}
```

### 403 — This account is not enabled for the v3 API.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "no_pricing_configured",
    "message": "No pricing configured for this API"
  }
}
```

### 429 — Rate limit exceeded.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```

### 500 — Something went wrong on our side.

- `error` (object)
  - `type` (string) — Stable, machine-readable error code.
  - `message` (string) — Human-readable explanation. Do not match on this.

```json
{
  "error": {
    "type": "string",
    "message": "string"
  }
}
```