Skip to main content
POST
https://api.gtmapis.com
/
v1
/
profile
/
enrich
Profile Enrichment
curl --request POST \
  --url https://api.gtmapis.com/v1/profile/enrich \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "<string>",
  "linkedin_url": "<string>"
}
'
{
  "profile": {
    "first_name": "<string>",
    "last_name": "<string>",
    "full_name": "<string>",
    "email": "<string>",
    "personal_email": "<string>",
    "mobile": "<string>",
    "linkedin_url": "<string>",
    "twitter_url": "<string>",
    "profile_picture": "<string>",
    "title": "<string>",
    "headline": "<string>",
    "department": "<string>",
    "seniority": "<string>",
    "company": "<string>",
    "company_domain": "<string>",
    "company_size": "<string>",
    "industry": "<string>",
    "location": "<string>",
    "city": "<string>",
    "region": "<string>",
    "country": "<string>",
    "country_code": "<string>",
    "skills": [
      {}
    ],
    "experience": [
      {}
    ],
    "education": [
      {}
    ],
    "connections": 123,
    "followers": 123,
    "recent_job_change": true,
    "job_change_date": "<string>",
    "previous_company": "<string>",
    "previous_title": "<string>"
  },
  "found": true,
  "confidence": 123,
  "source_provider": "<string>",
  "credits_charged": 123,
  "cache_hit": true,
  "latency_ms": 123
}

​
Profile Enrichment

Enrich your contact data with comprehensive professional profile information using an email address or LinkedIn URL.

​
Endpoint

POST /v1/profile/enrich

​
Request

​
email
string
Email address to look up. Either email or linkedin_url is required.
​
linkedin_url
string
LinkedIn profile URL. Either email or linkedin_url is required.

​
Example Request

curl -X POST https://api.gtmapis.com/v1/profile/enrich \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "email": "john.doe@acme.com"
  }'

​
Response

​
Profile Object

​
profile
object
​
found
boolean
Whether a profile was found
​
confidence
integer
Confidence score (0-100)
​
source_provider
string
Data provider that returned the result
​
credits_charged
integer
Credits charged for this request
​
cache_hit
boolean
Whether result was served from cache
​
latency_ms
integer
Request time in milliseconds

​
Success Response

{
  "profile": {
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "email": "john.doe@acme.com",
    "mobile": "+14155551234",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "twitter_url": "https://twitter.com/johndoe",
    "profile_picture": "https://media.licdn.com/...",
    "title": "VP of Sales",
    "headline": "Helping companies grow revenue | VP Sales @ Acme",
    "department": "Sales",
    "seniority": "VP",
    "company": "Acme Inc",
    "company_domain": "acme.com",
    "company_size": "51-200",
    "industry": "Software",
    "location": "San Francisco, California, United States",
    "city": "San Francisco",
    "region": "California",
    "country": "United States",
    "country_code": "US",
    "skills": ["Sales", "B2B Sales", "SaaS", "Account Management", "Negotiation"],
    "experience": [
      {
        "company": "Acme Inc",
        "title": "VP of Sales",
        "department": "Sales",
        "location": "San Francisco, CA",
        "start_date": "2022-03",
        "end_date": "",
        "is_current": true,
        "description": "Leading sales team..."
      },
      {
        "company": "Previous Corp",
        "title": "Sales Director",
        "start_date": "2019-06",
        "end_date": "2022-02",
        "is_current": false
      }
    ],
    "education": [
      {
        "school": "Stanford University",
        "degree": "MBA",
        "field": "Business Administration",
        "start_year": 2014,
        "end_year": 2016
      }
    ],
    "connections": 2500,
    "followers": 1800,
    "recent_job_change": false
  },
  "found": true,
  "confidence": 95,
  "source_provider": "peopledatalabs",
  "credits_charged": 3,
  "cache_hit": false,
  "latency_ms": 567
}

​
Not Found Response

{
  "profile": null,
  "found": false,
  "confidence": 0,
  "credits_charged": 0,
  "cache_hit": false,
  "latency_ms": 234,
  "error": "Profile not found"
}

​
Credit Pricing

ResultCredits Charged
Profile found3 credits
Not found0 credits
Error / failure0 credits
Profiles are cached for 7 days. Cache hits are charged at the same rate to ensure data freshness.

​
Seniority Levels

The API normalizes seniority into these categories:
LevelExamples
C-LevelCEO, CTO, CFO, COO
VPVP of Sales, Vice President
DirectorSales Director, Director of Engineering
ManagerSales Manager, Product Manager
SeniorSenior Engineer, Senior Account Executive
IndividualSoftware Engineer, Account Executive
InternSales Intern, Engineering Intern

​
Error Responses

​
400 Bad Request

{
  "error": "Bad Request",
  "message": "email or linkedin_url required"
}

​
401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

​
503 Service Unavailable

{
  "error": "Service Unavailable",
  "message": "profile enrichment not configured"
}

​
Use Cases

Use seniority, company size, and industry to score and prioritize leads.
Reference recent job changes, education, or shared skills in your messaging.
Automatically populate CRM fields with comprehensive profile data.
Monitor prospects for job changes to trigger timely outreach.
Build detailed profiles of key contacts before important meetings.

Person Lookup

Find profiles by name and company

Email to LinkedIn

Convert email to LinkedIn URL

Mobile Finder

Find mobile phone numbers

Company Enrichment

Enrich company data