Individual Lookup

Resolve one person's LinkedIn profile URL from their name and company. Synchronous, returns the URL directly.

POST /find_profile

Costs 0.5 credits per row, charged only when a profile is found. Returns the URL directly in the response, no list and no polling.

Pass a person's full name and the company they work at. The response contains the resolved URL in data.person_linkedin_url.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
name	string	Full name of the person.
company_name	string	Company they work at.

Example

Input

{
  "api_key": "your_api_key",
  "name": "Jane Doe",
  "company_name": "Acme Corp"
}

Output

{
  "status": "success",
  "data": {
    "person_name": "Jane Doe",
    "organization_name": "Acme Corp",
    "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/"
  },
  "credits_used": 0.5,
  "credits_remaining": 4823,
  "success": true
}

Not found

{
  "status": "not_found",
  "data": {
    "person_name": "Jane Doe",
    "organization_name": "Acme Corp",
    "person_linkedin_url": null
  },
  "credits_used": 0,
  "credits_remaining": 4823,
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "name: Field required"
  },
  "success": false
}

Response

Field	Type	Description
person_name	string	The name that was searched for. Sent as name in the request.
organization_name	string	The company that was searched against. Sent as company_name in the request.
person_linkedin_url	string	The resolved profile URL, or null when no profile was matched.

The request fields keep their original names, the response uses the standard ones — so a resolved row can be written straight back to a list.

The record is under data. See Response Format for the fields every endpoint returns.

To resolve a URL for every contact in a list in one call instead, use List Lookup.