BEbettercontact

Enrich a lead profile

Changed on

Look up a single person and get their profile plus their current company. This endpoint is synchronous: the profile comes back in the same response, there is no request_id to poll.

Cost: 0.1 credit per profile found. Nothing is charged when no profile matches.

It returns profile data only. It does not return an email address or a phone number: for that, use Enrich leads.

Authentication accepts either the X-API-Key header like every other endpoint, or an api_key attribute in the request body.

post/enrich_profile/lead

Request

  • Base URL
    https://app.bettercontact.rocks/api/v2
  • URL
    https://app.bettercontact.rocks/api/v2/enrich_profile/lead
  • Auth
    API key in header X-API-Key

Request body

linkedin_urlstring

Public LinkedIn profile URL of the contact. Sufficient on its own.

first_namestring

First name. Required when you do not send linkedin_url.

last_namestring

Last name. Required when you do not send linkedin_url.

company_domainstring

Company domain. Required when you do not send linkedin_url.

companystring

Company name. Complements company_domain, it cannot replace it.

api_keystring

Your API key. Only needed if you do not send the X-API-Key header.

Example request

{
  "linkedin_url": "https://www.linkedin.com/in/veronick-martinuzzi-a4533373",
  "first_name": "Veronick",
  "last_name": "Martinuzzi",
  "company_domain": "hondaresearch.com",
  "company": "Honda R&D Americas"
}

Response

Profile found.

successboolean

Example response

{
  "success": true,
  "data": {
    "contact_id": 98012430,
    "contact_first_name": "Veronick",
    "contact_last_name": "Martinuzzi",
    "contact_full_name": "Veronick Martinuzzi",
    "contact_job_title": "Development solutions sr. principal engineer",
    "contact_seniority": "Senior",
    "contact_industry": "Motor vehicle manufacturing",
    "contact_linkedin_profile_url": "https://www.linkedin.com/in/veronick-martinuzzi-a4533373",
    "contact_location_country": "United states",
    "contact_location_state": "Ohio",
    "company_name": "Honda rd americas",
    "company_domain": "hondaresearch.com",
    "company_linkedin_url": "https://www.linkedin.com/company/honda-r&d",
    "company_industry": "Motor vehicle manufacturing",
    "company_employees_range_start": 10001,
    "company_headquarters_city": "Ohio center; 21001 state route 739; raymond",
    "company_headquarters_country": "United states",
    "company_keywords": [
      "automotive",
      "auto development",
      "design",
      "research",
      "products",
      "honda"
    ]
  }
}

Changes