Batch Lookup

Fetch person + company for up to ten LinkedIn URLs in a single call. Returns every record inline — nothing is written to a list.

POST /profile_with_company_bulk

The batch counterpart of Individual Lookup. Send up to 10 distinct LinkedIn profile URLs and get every person + company record back in one response. This route is synchronous — there is no list to poll and no download step.

Pricing is per row and identical to calling /profile_with_company once per URL: 0.1 credit for the person (0.3 with full_profile: true), plus 0.1 credit when company data comes back. Misses cost nothing.

Duplicate URLs are collapsed before billing, and people who share an employer share one company lookup.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
person_linkedin_urls	string[]	LinkedIn profile URLs to look up. At least 1, at most 10 distinct URLs per call. Duplicates are collapsed.
full_profile	boolean	Optional. Default false. Applies to every URL in the batch. true uses the richer full profile (0.3 credit per person).
include_raw	boolean	Optional. Default false. Asks for the provider payload alongside the normalized record.

Leave include_raw off unless you need it. At batch size — especially with full_profile — the raw payload is the main driver of response weight.

Row statuses

Each row carries its own status, so one bad URL never costs you the rest of the batch.

Status	Meaning	Billed
success	Person and company both returned.	Person + company
person_only	Person returned; company missing or timed out.	Person only
person_failed	The provider had no data for this URL.	Free
not_found	Nothing came back for this URL. A message says why.	Free
timed_out	The batch deadline was reached before this row finished.	Free

Response

data is an array with one object per unique URL you sent.

Field	Type	Description
person_linkedin_url	string	The URL this row answers.
status	string	The row status from the table above.
profile	object	The person. Same fields as Profile Only.
company	object	The company from their current position. null when the company could not be read.
credits_used	number	What this row cost.
message	string	Present only when the row returned nothing, saying why.

Alongside data, the response carries total (rows returned), rows_requested (URLs you sent) and rows_unique (URLs left after duplicates were collapsed).

See Response Format for the fields every endpoint returns.

Example

Input

{
  "api_key": "your_api_key",
  "person_linkedin_urls": [
    "https://www.linkedin.com/in/williamhgates/",
    "https://www.linkedin.com/in/satyanadella/"
  ],
  "full_profile": false,
  "include_raw": false
}

Output

{
  "status": "success",
  "data": [
    {
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "status": "success",
      "profile": {
        "person_name": "Bill Gates",
        "first_name": "Bill",
        "last_name": "Gates",
        "current_title": null,
        "headline": null,
        "person_linkedin_url": "https://www.linkedin.com/in/Williamhgates",
        "organization_name": "Gates Foundation",
        "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
        "city": null,
        "state": null,
        "country": null,
        "country_code": null,
        "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft…",
        "open_to_work": null,
        "follower_count": 40599152,
        "connection_count": null,
        "work_experience": [
          {
            "company_name": "Gates Foundation",
            "current_title": null,
            "location": null,
            "start_date": null,
            "end_date": null,
            "is_current": true,
            "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
            "description": null,
            "employment_type": null,
            "extra": { "company_id": "gates-foundation" }
          }
        ],
        "education_history": [
          {
            "school_name": "Harvard University",
            "degree": null,
            "field_of_study": null,
            "start_date": null,
            "end_date": null,
            "school_linkedin_url": "https://www.linkedin.com/school/harvard-university",
            "extra": { "period": "1973 - 1975" }
          }
        ],
        "skills": null,
        "profile_picture_url": null,
        "linkedin_id": "251749025",
        "extra": { "public_identifier": "williamhgates" }
      },
      "company": {
        "organization_name": "Gates Foundation",
        "company_linkedin_url": null,
        "company_website": null,
        "domain": null,
        "industry": "Non-profit Organizations",
        "industries": ["Non-profit Organizations"],
        "company_size": "1001-5000",
        "headcount": 4223,
        "headquarters": {
          "city": null,
          "state": null,
          "country": null,
          "country_code": null,
          "raw": "Seattle, WA 98109, US"
        },
        "company_description": null,
        "company_keywords": ["Global Health", "Global Development", "US Education"],
        "company_logo": null,
        "follower_count": 1523109,
        "year_founded": null,
        "organization_type": "Nonprofit",
        "linkedin_id": "gates-foundation"
      },
      "credits_used": 0.2
    }
  ],
  "total": 2,
  "rows_requested": 2,
  "rows_unique": 2,
  "credits_used": 0.4,
  "credits_remaining": 4522.3,
  "success": true
}

Error

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

The second row is trimmed from the example above for brevity — data holds one object per unique URL you sent.

Related

• Individual Lookup — a single URL.

• List Lookup — more than 10 contacts.