Domain intelligence

Get entity intelligence by domain

GET /v1/domain-intelligence

View as markdown Open in ChatGPT Open in Claude

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 →

Query parameters

domainstring required
The domain name to analyze (e.g., coupa.com, apple.com)

Responses

200 OK

domainstring
The domain that was queried
statusstring (enum)
completebuildingrefreshingerror
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
dataobject
The domain intelligence data (present when status is "complete" or "refreshing", null when "building")
Show 9 nested fieldsHide nested fields
- statusstring (enum)
  matchedpartial_matchinconclusiveno_match
  Status of the entity resolution
- confidenceinteger
  Confidence score of the match (0-100)
- typestring (enum)
  businessnonprofitgovernmentpersonotherunknown
  The entity type
- subtypestring (enum)
  Show 9 possible valuesHide possible values
  incorporated_entityunincorporated_entitynonprofit_entitygovernment_entitynatural_personcomplex_business_structuretrading_name_onlyother_entityunknown
  The entity subtype
- entityobject
  High-confidence entity match (see Entity Resolution API for details)
  Show 8 nested fieldsHide nested fields
  idstring
  The stable entity ID that can be used with the /v1/entities/{entity_id} endpoint
  namestring
  statusstring (enum)
  activeinactive
  descriptionstring
  websitestring
  headquartersobject
  primary_legal_entityobject
  matching_branchobject
- candidateobject
  Lower-confidence match or unsupported entity type
- factorsarray<object>
  Factors contributing to the match decision
- actionsarray<object>
  Suggested actions for improving results
- domain_intelligenceobject
  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.
  Show 9 nested fieldsHide nested fields
  domainstring
  urlstring <uri>
  descriptionstring
  Domain-specific business description
  classificationobject
  Show 4 nested fieldsHide nested fields
  naics_codes_2022array<object>
  Show 5 nested fieldsHide nested fields
  codestring
  namestring
  relevanceinteger
  confidenceinteger
  is_primaryboolean
  business_modelarray<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_servicesarray<string>
  business_tagsarray<string>
  domain_contextobject
  Show 4 nested fieldsHide nested fields
  domain_typestring
  domain_relationshipstring
  domain_purposestring
  business_relevancestring
  domain_aliasesarray<string>
  tranco_rankinteger
  website_statusobject
  Show 6 nested fieldsHide nested fields
  statusinteger
  is_resolvableboolean
  is_webserver_responsiveboolean
  has_contentboolean
  failure_reasonstring
  last_checkedstring <date-time>
  is_disposable_email_providerboolean
messagestring
Human-readable message about the status
metadataobject
Show 3 nested fieldsHide nested fields
- last_updatedstring <date-time>
- processing_started_atstring <date-time>
- estimated_completionstring <date-time>

400 Bad Request

errorobject
An error object.
Show 2 nested fieldsHide nested fields
- messagestring
  The error message
- typestring
  The error code

401 Unauthorized

messagestring
The error object.
request_idstring
The request ID for the error.

500 Internal Server Error

errorobject
An error object.
Show 2 nested fieldsHide nested fields
- messagestring
  The error message
- typestring
  The error code

502 Request timeout

errorobject
An error object.
Show 2 nested fieldsHide nested fields
- messagestring
  The error message
- typestring
  The error code

Example request

cURL

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

Example response

Domain intelligence complete response200

{
  "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
  }
}

Domain intelligence building response

{
  "domain": "newstartup.com",
  "status": "building",
  "data": null,
  "message": "Initial data compilation in progress. Please poll this endpoint in 5-10 seconds.",
  "metadata": {
    "last_updated": null,
    "processing_started_at": "2025-07-25T20:15:30.123Z",
    "estimated_completion": "2025-07-25T20:18:30.000Z"
  }
}

Domain intelligence refreshing response

{
  "domain": "coupa.com",
  "status": "refreshing",
  "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.",
      "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."
      }
    ],
    "actions": [],
    "domain_intelligence": {
      "domain": "coupa.com",
      "url": "https://www.coupa.com/",
      "description": "Coupa Software Incorporated is an AI-native total spend management platform.",
      "classification": {
        "naics_codes_2022": [
          {
            "code": "541511",
            "name": "Custom Computer Programming Services",
            "relevance": 95,
            "confidence": 95,
            "is_primary": true
          }
        ],
        "business_model": [
          "B2B SaaS"
        ],
        "products_services": [
          "AI-native total spend management platform",
          "Procure-to-Pay"
        ],
        "business_tags": [
          "Spend Management",
          "Procurement Software",
          "B2B"
        ]
      },
      "domain_context": {
        "domain_type": "corporate_website",
        "domain_relationship": "direct_owner",
        "domain_purpose": "The domain serves as the company's primary online presence.",
        "business_relevance": "Central to Coupa's business strategy."
      },
      "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": "Data refresh in progress - current data available. Updated data expected soon.",
  "metadata": {
    "last_updated": "2025-07-03T02:15:17.471Z",
    "processing_started_at": "2025-07-25T20:45:15.567Z",
    "estimated_completion": "2025-07-25T20:48:00.000Z"
  }
}