# Get entity intelligence by domain

`GET /v1/domain-intelligence`

> Tag: Domain intelligence

Retrieve comprehensive entity information and domain-specific intelligence by providing a domain name. 
This API combines entity resolution with domain analysis and supports real-time data compilation.

**Key Features:**
- Entity resolution with high-confidence matching
- Domain-specific business intelligence (separate from parent entity data)
- Real-time polling architecture (building/complete/refreshing states)
- Integration with Entity Data API via returned entity IDs

**Important Notes:**
- Domain intelligence reflects the specific domain's purpose, not the entire parent company
- Entity IDs can be used with `/v1/entities/{entity_id}` for comprehensive business data
- Poll endpoint every 5-10 seconds when status is "building" or "refreshing"

📖 **[Complete Guide & Examples →](/docs/apis/domain-intelligence/)**

## Request

### Query parameters

- `domain` (string, required) — The domain name to analyze (e.g., coupa.com, apple.com)

### Example request

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

## Responses

### 200 — OK

- `domain` (string) — The domain that was queried
- `status` (string (enum)) — Status of the domain intelligence request: * `building` - Initial data compilation is in progress, no data available yet * `complete` - Domain intelligence is complete and current * `refreshing` - Previously compiled data is available but being refreshed * `error` - An error occurred during processing
- `data` (object) — The domain intelligence data (present when status is "complete" or "refreshing", null when "building")
  - `status` (string (enum)) — Status of the entity resolution
  - `confidence` (integer) — Confidence score of the match (0-100)
  - `type` (string (enum)) — The entity type
  - `subtype` (string (enum)) — The entity subtype
  - `entity` (object) — High-confidence entity match (see Entity Resolution API for details)
    - `id` (string) — The stable entity ID that can be used with the /v1/entities/{entity_id} endpoint
    - `name` (string)
    - `status` (string (enum))
    - `description` (string)
    - `website` (string)
    - `headquarters` (object)
    - `primary_legal_entity` (object)
    - `matching_branch` (object)
  - `candidate` (object) — Lower-confidence match or unsupported entity type
  - `factors` (array<object>) — Factors contributing to the match decision
  - `actions` (array<object>) — Suggested actions for improving results
  - `domain_intelligence` (object) — Domain-specific intelligence and enrichment. This data is analyzed from the perspective of the specific domain, not the entire parent entity. Industry classifications, products, and services listed here reflect what the domain represents, which may be a subset of the parent entity's full business portfolio.
    - `domain` (string)
    - `url` (string <uri>)
    - `description` (string) — Domain-specific business description
    - `classification` (object)
      - `naics_codes_2022` (array<object>)
      - `business_model` (array<string>) — **Deprecated.** Free-text business-model labels — not a controlled vocabulary. Superseded on the `/v3` surface by the enumerated `market_segment` and `revenue_model`. **Unchanged on `/v1`, still populated, no removal date.**
      - `products_services` (array<string>)
      - `business_tags` (array<string>)
    - `domain_context` (object)
      - `domain_type` (string)
      - `domain_relationship` (string)
      - `domain_purpose` (string)
      - `business_relevance` (string)
    - `domain_aliases` (array<string>)
    - `tranco_rank` (integer)
    - `website_status` (object)
      - `status` (integer)
      - `is_resolvable` (boolean)
      - `is_webserver_responsive` (boolean)
      - `has_content` (boolean)
      - `failure_reason` (string)
      - `last_checked` (string <date-time>)
    - `is_disposable_email_provider` (boolean)
- `message` (string) — Human-readable message about the status
- `metadata` (object)
  - `last_updated` (string <date-time>)
  - `processing_started_at` (string <date-time>)
  - `estimated_completion` (string <date-time>)

```json
{
  "domain": "coupa.com",
  "status": "complete",
  "data": {
    "status": "matched",
    "confidence": 98,
    "type": "business",
    "subtype": "incorporated_entity",
    "entity": {
      "id": "siq_2ZY0rnm69XBVBD61EPaQN",
      "name": "Coupa Software Incorporated",
      "status": "active",
      "description": "Coupa Software Incorporated is a technology platform providing AI-driven total spend management and supply chain solutions. The company's platform helps businesses gain visibility into and control over their spending, optimize supply chains, and manage cash.",
      "headquarters": {
        "address": null,
        "city": "Foster City",
        "state": "California",
        "country": "United States",
        "state_code": "CA",
        "country_code": "US"
      },
      "website": "https://www.coupa.com/",
      "primary_legal_entity": {
        "id": "le_2Zp3Yka7xrumoaIFXLxkl",
        "name": "COUPA SOFTWARE INCORPORATED",
        "country_code": "US",
        "state_code": null,
        "jurisdiction": "Delaware"
      },
      "matching_branch": null
    },
    "candidate": null,
    "factors": [
      {
        "code": "legal_entity_confirmed_on_website",
        "type": "strength",
        "impact": "Provides direct confirmation of the legal entity operating the domain.",
        "description": "The domain 'coupa.com' identifies 'Coupa Software Incorporated' in its legal pages and terms of service."
      },
      {
        "code": "domain_content_matches_entity",
        "type": "strength",
        "impact": "Confirms the domain's content is consistent with the identified entity's operations.",
        "description": "The domain content strongly aligns with Coupa Software Incorporated's business as a provider of cloud-based Business Spend Management solutions."
      }
    ],
    "actions": [],
    "domain_intelligence": {
      "domain": "coupa.com",
      "url": "https://www.coupa.com/",
      "description": "Coupa Software Incorporated is an AI-native total spend management platform providing solutions for procurement, finance, supply chain, and IT for businesses of all sizes.",
      "classification": {
        "naics_codes_2022": [
          {
            "code": "541511",
            "name": "Custom Computer Programming Services",
            "relevance": 95,
            "confidence": 95,
            "is_primary": true
          },
          {
            "code": "54",
            "name": "Professional, Scientific, and Technical Services",
            "relevance": 70,
            "confidence": 90,
            "is_primary": false
          }
        ],
        "business_model": [
          "B2B SaaS"
        ],
        "products_services": [
          "AI-native total spend management platform",
          "Supply Chain Design & Planning",
          "Source-to-Contract",
          "Procure-to-Pay",
          "AP Automation",
          "Treasury & Cash Management"
        ],
        "business_tags": [
          "Spend Management",
          "Procurement Software",
          "Finance Solutions",
          "Supply Chain Management",
          "AI",
          "Cloud Platform",
          "B2B"
        ]
      },
      "domain_context": {
        "domain_type": "corporate_website",
        "domain_relationship": "direct_owner",
        "domain_purpose": "The domain serves as the company's primary online presence, providing information about its products, services, and company information.",
        "business_relevance": "The domain is central to Coupa's business strategy, serving as a key channel for marketing, customer engagement, and providing access to its platform."
      },
      "domain_aliases": [
        "exari.com"
      ],
      "tranco_rank": 32137,
      "website_status": {
        "status": 200,
        "is_resolvable": true,
        "is_webserver_responsive": true,
        "has_content": true,
        "failure_reason": null,
        "last_checked": "2025-07-25T19:40:38.079Z"
      },
      "is_disposable_email_provider": null
    }
  },
  "message": null,
  "metadata": {
    "last_updated": "2025-07-03T02:15:17.471Z",
    "processing_started_at": null,
    "estimated_completion": null
  }
}
```

### 400 — Bad Request

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "Bad request",
    "type": "bad_request"
  }
}
```

### 401 — Unauthorized

- `message` (string) — The error object.
- `request_id` (string) — The request ID for the error.

```json
{
  "message": "No API key found in request",
  "request_id": "d6ed1709fa87777bb373fd60a810e717"
}
```

### 500 — Internal Server Error

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "An unexpected error occurred.",
    "type": "api_error"
  }
}
```

### 502 — Request timeout

- `error` (object) — An error object.
  - `message` (string) — The error message
  - `type` (string) — The error code

```json
{
  "error": {
    "message": "Request timeout",
    "type": "timeout"
  }
}
```