SavvyIQ
v3 (preview)
You're viewing the v3 (preview) edition of the API. View the current version →

Domain Intelligence

Resolve a domain

GET /v3/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.

Query parameters

  • domainstring 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.

Responses

200 Always returned, including while research is still running. Check `status`.
  • domainstring
    The normalized root domain.
  • statusstring (enum)
    completebuildingpendingrefreshingfailed
    complete means data is populated. building and pending mean research is still running and data is null.
  • messagestring
  • request_idstring
  • metadataobject
    Show 3 nested fieldsHide nested fields
    • last_updatedstring <date-time>
    • processing_started_atstring <date-time>
    • estimated_completionstring <date-time>
  • dataobject
    Null until status is complete.
    Show 10 nested fieldsHide nested fields
    • statusstring (enum)
      matchedpartial_matchinconclusiveno_match
    • confidenceinteger
    • typestring
    • subtypestring
    • entityobject
      Show 10 nested fieldsHide nested fields
      • idstring
      • display_namestring
        The brand or common name.
      • legal_namestring
        The registered name, as it appears on the government record.
      • statusstring (enum)
        activeinactive
      • descriptionstring
      • websitestring
      • headquartersobject
        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.
        Show 1 nested fieldHide nested fields
        • addressobject
          Show 10 nested fieldsHide nested fields
          • street_addressstring
          • street_numberstring
          • sub_premisestring
          • citystring
          • statestring
            Subdivision as written ("California"), when we hold it.
          • state_codestring
            ISO-3166-2 subdivision code ("CA"). Derived from state when we can map it confidently; null rather than guessed when we cannot.
          • postal_codestring
          • countrystring
          • country_codestring
          • formatted_addressstring
            Single-line rendering of the parts above. Composed from them when we hold no stored formatting.
      • primary_legal_entityobject
        The government registration that anchors this entity.
        Show 5 nested fieldsHide nested fields
        • idstring
        • jurisdictionstring
        • country_codestring
        • state_codestring
        • registration_authorityobject
          The government register this entity is recorded in.
          Show 7 nested fieldsHide nested fields
          • idinteger
          • codestring
          • namestring
          • organizationstring
          • jurisdictionstring
          • country_codestring
          • websitestring
      • identifiersarray<object>
        Typed external identifiers, in a stable order.
        Show 3 nested fieldsHide nested fields
        • typestring (enum)
          registration_idciksec_cikleibiceindunsticker
        • valuestring
          Canonicalized for its type on the resolution and record endpoints. See Codes & enums.
        • jurisdictionstring
          ISO jurisdiction, where the identifier type is jurisdictional. Absent entirely on /v3/domain-intelligence.
      • matching_branchobject
        Set when the query matched a specific branch or foreign registration rather than the entity's home registration.
    • candidateobject
      Our best hypothesis when an entity could not be confirmed. A response populates entity or candidate, never both.
      Show 6 nested fieldsHide nested fields
      • namestring
      • legal_namestring
      • jurisdictionstring
      • statusstring
      • descriptionstring
      • primary_addressobject
        Show 3 nested fieldsHide nested fields
        • full_addressstring
        • state_codestring
        • country_codestring
    • factorsarray<object>
      Show 4 nested fieldsHide nested fields
      • codestring
        Stable code. See Codes & enums.
      • typestring (enum)
        strengthlimitation
      • descriptionstring
      • impactstring
    • actionsarray<object>
      Show 2 nested fieldsHide nested fields
      • codestring
      • descriptionstring
    • domain_intelligenceobject
      What we know about the domain itself, as distinct from the company behind it.
      Show 11 nested fieldsHide nested fields
      • domainstring
      • urlstring
      • domain_aliasesarray<string>
      • descriptionstring
      • tranco_rankinteger
        Global traffic rank. Lower is bigger.
      • website_statusobject
        Reachability of the domain when we last checked it.
        Show 6 nested fieldsHide nested fields
        • statusinteger
          HTTP status code observed.
        • is_resolvableboolean
        • is_webserver_responsiveboolean
        • has_contentboolean
        • failure_reasonstring
        • last_checkedstring <date-time>
      • domain_contextobject
        What this domain is, and how it relates to the business behind it.
        Show 4 nested fieldsHide nested fields
        • domain_typestring (enum)
          Show 13 possible valuesHide possible values
          corporate_websiteinfrastructureservice_platformemail_domainapi_endpointcdn_domainsubdomainparked_domainpersonal_sitecontent_platformplaceholder_pagenon_businessother
        • domain_relationshipstring (enum)
          direct_ownerparent_companyinfrastructure_providerservice_provideremail_providerplatform_provider
        • domain_purposestring
        • business_relevancestring
      • is_disposable_email_providerboolean
      • industryobject
        Industry codes keyed by scheme. A scheme that was not classified is absent; an empty key is never returned.
        Show 1 nested fieldHide nested fields
        • schemesobject
          Show 2 nested fieldsHide nested fields
          • naics_2022array<object>
            Show 4 nested fieldsHide nested fields
            • codestring
            • labelstring
            • is_primaryboolean
              One code per scheme is primary. Primary codes are returned first.
            • confidenceinteger
          • sicarray<object>
            Show 4 nested fieldsHide nested fields
            • codestring
            • labelstring
            • is_primaryboolean
              One code per scheme is primary. Primary codes are returned first.
            • confidenceinteger
      • classificationobject
        Scoped to this domain's observable motion, which can legitimately differ from the whole company's. Compare with classification on /v3/entities/{id}.
        Show 7 nested fieldsHide nested fields
        • sectorstring
        • industrystring
        • sub_industrystring
        • business_tagsarray<string>
        • market_segmentsarray<string (enum)>
        • revenue_modelsarray<string>
        • products_servicesarray<string>
      • social_profilesobject
        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.
        Show 4 nested fieldsHide nested fields
        • linkedinobject
          Show 1 nested fieldHide nested fields
          • handlestring
        • facebookobject
          Show 1 nested fieldHide nested fields
          • handlestring
        • crunchbaseobject
          Show 1 nested fieldHide nested fields
          • handlestring
        • twitterobject
          Show 1 nested fieldHide nested fields
          • handlestring
    • redirect_infoobject
      Present only when the requested domain redirected elsewhere.
      Show 5 nested fieldsHide nested fields
      • is_redirectboolean
      • original_domainstring
      • final_domainstring
      • redirect_status_codeinteger
      • redirect_typestring
400 Invalid or missing parameters.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.
401 Missing or invalid API key.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.
402 Credit balance exhausted.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.
403 This account is not enabled for the v3 API.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.
429 Rate limit exceeded.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.
500 Something went wrong on our side.
  • errorobject
    Show 2 nested fieldsHide nested fields
    • typestring
      Stable, machine-readable error code.
    • messagestring
      Human-readable explanation. Do not match on this.

Example request

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

Example response

Datadog, resolved from its domain200
{
  "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"
}