Sign in

v1

latestOpenAPI 3.0.32026-07-222085264.6 KB
Person APIs
Enrich APIs

Enrich only person contact data from cached dataset

Enrich only the contact data for a person — business emails, personal emails, and phone numbers — using the Crustdata cached dataset. Provide either a profile URL or a business email. Exactly one identifier type must be provided per request. Supports batch enrichment of up to 25 identifiers at once.

This endpoint mirrors /person/enrich but is scoped to contact fields: the only enrichable fields are contact.business_emails, contact.personal_emails, and contact.phone_numbers. Requesting any non-contact field returns a 400 error listing the available contact fields. When fields is omitted, all three contact tiers are enriched. Each submitted identifier returns one result entry; an identifier with no contact match returns an empty matches array. <Note> Default rate-limit is 15 requests per minute. Send an email to gtm@crustdata.co to discuss higher limits if needed for your use case. </Note>

post/person/contact/enrich

Headers

x-api-version'2025-11-01' required
Example:2025-11-01

API version to use. This endpoint currently requires 2025-11-01.

Request body

OR

Example request

{
  "professional_network_profile_urls": [
    "https://www.linkedin.com/in/dvdhsu/"
  ],
  "business_emails": [
    "david@example.com"
  ],
  "fields": [
    "contact.business_emails",
    "contact.phone_numbers"
  ]
}

Response

Enriched person contact data. Returns a top-level array with one entry per submitted identifier; unmatched identifiers return an empty matches array.

matched_onstring

The specific input value this entry corresponds to (a profile URL or a business email).

match_type'professional_network_profile_url' | 'business_email'

Which identifier type the input was matched on.

Example response

[
  {
    "matched_on": "https://www.linkedin.com/in/dvdhsu/",
    "match_type": "professional_network_profile_url",
    "matches": [
      {
        "confidence_score": 1,
        "person_data": {
          "crustdata_person_id": 14540,
          "contact": {
            "business_emails": [
              {
                "email": "david@example.com",
                "status": "deliverable"
              }
            ],
            "personal_emails": [],
            "phone_numbers": []
          }
        }
      }
    ]
  }
]