Person Lookup

Find a person LinkedIn profile using name and company

POST /v1/people/lookup

Person Lookup

cURL

curl --request POST \
  --url https://api.gtmapis.com/v1/people/lookup \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "company_domain": "<string>",
  "title": "<string>",
  "location": "<string>",
  "enrich_profile": true
}
'

200

{
  "linkedin_url": "<string>",
  "profile": {},
  "similarity_scores": {},
  "found": true,
  "confidence": 123,
  "source_provider": "<string>",
  "credits_charged": 123,
  "cache_hit": true,
  "latency_ms": 123
}

Person Lookup

Find a LinkedIn profile for a person given their name and company domain. Optionally enrich with full profile data.

Endpoint

POST /v1/people/lookup

Request

first_name · string · required

The person’s first name

last_name · string

The person’s last name (recommended for better accuracy)

company_domain · string · required

Company domain (e.g., “acme.com”)

title · string

Job title hint for better matching

location · string

Location hint (city, state, or country)

enrich_profile · boolean · default: "false"

If true, returns full profile data (adds 1 credit)

Example Request

cURL

curl -X POST https://api.gtmapis.com/v1/people/lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "company_domain": "acme.com",
    "enrich_profile": true
  }'

Response

linkedin_url · string

The person’s LinkedIn profile URL

profile · object

Full profile data (only if enrich_profile: true). See Profile Enrichment for fields.

similarity_scores · object

Fuzzy match confidence scores:

• name: Name similarity (0-1)
• company: Company match score (0-1)
• title: Title similarity (0-1)
• location: Location match score (0-1)

found · boolean

Whether a matching person was found

confidence · integer

Overall 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

{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "profile": {
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "title": "VP of Sales",
    "company": "Acme Inc",
    "company_domain": "acme.com",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "location": "San Francisco, CA",
    "seniority": "VP"
  },
  "similarity_scores": {
    "name": 1.0,
    "company": 0.95,
    "title": 0.0,
    "location": 0.0
  },
  "found": true,
  "confidence": 92,
  "source_provider": "peopledatalabs",
  "credits_charged": 3,
  "cache_hit": false,
  "latency_ms": 456
}

Not Found Response

{
  "linkedin_url": "",
  "found": false,
  "confidence": 0,
  "credits_charged": 0,
  "cache_hit": false,
  "latency_ms": 234,
  "error": "No matching person found"
}

Credit Pricing

Result	Credits Charged
LinkedIn URL found	2 credits
LinkedIn URL found + profile enrichment	3 credits
Not found	0 credits
Error / failure	0 credits

Cache hits are charged at the same rate. Results are cached for 7 days.

Error Responses

400 Bad Request

{
  "error": "Bad Request",
  "message": "first_name is required"
}

401 Unauthorized

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

503 Service Unavailable

{
  "error": "Service Unavailable",
  "message": "person lookup not configured"
}

Use Cases

Pre-call research

Look up prospects before sales calls to understand their background, tenure, and career trajectory.

CRM enrichment

Enhance your CRM records with LinkedIn URLs for better contact management and social selling.

Lead qualification

Verify that contacts match expected job titles and companies before outreach.

Build contact lists

Find LinkedIn profiles for contacts you only have name + company for.

Related Endpoints

Role Lookup

Find people by job role at a company

Email to LinkedIn

Convert work email to LinkedIn profile

Profile Enrichment

Get full profile data from email or LinkedIn