Individual Lookup

Fetch a LinkedIn profile plus the person's current company in one call.

POST /profile_with_company

Profile with Company costs 0.2 credit per call (5 profiles + companies for 1 credit). Set full_profile to true for the richer person lookup plus company, which costs 0.4 credit per call. If the company cannot be retrieved you are billed for the person only. Pass listname and a company already checked on that list recently is free: you pay for the person only.

The field is person_linkedin_url. The older profile_url name is no longer accepted and returns a 422.

Reusing a recent company lookup. If the person is on one of your lists, pass that list as listname. When their company was already checked and charged on that list recently (by this endpoint, Company Profile, a Flow, or a list enrichment), the saved company record is used, the company part (0.1) is not charged, and message says when it was checked. Without listname the company is looked up and charged as usual.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
person_linkedin_url	string	The LinkedIn profile URL to look up.
full_profile	boolean	Optional. Default false (0.2 credit). true returns the full person profile + company (0.4 credit).
listname	string	Optional. A list the person is on. A company checked on that list recently is not charged again.

Response

data holds two records.

Field	Type	Description
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.

The company record carries organization_name, company_linkedin_url, company_website, domain, industry, industries, company_size, headcount, headquarters, company_description, company_keywords, company_logo, follower_count, year_founded, organization_type and linkedin_id. Anything the source returned that has no name here is kept under extra.

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

Example

Input

{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/williamhgates/",
  "full_profile": false
}

Output: Basic

{
  "status": "success",
  "data": {
    "profile": {
      "person_name": "Bill Gates",
      "first_name": null,
      "last_name": null,
      "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "headline": null,
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "organization_name": "Gates Foundation",
      "company_linkedin_url": null,
      "city": "Seattle",
      "state": "Washington",
      "country": "United States",
      "country_code": "us",
      "about": null,
      "open_to_work": null,
      "follower_count": 40527042,
      "connection_count": null,
      "work_experience": null,
      "education_history": null,
      "skills": null,
      "profile_picture_url": null,
      "linkedin_id": "williamhgates"
    },
    "company": {
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "company_website": "https://www.gatesfoundation.org/about/careers",
      "domain": "gatesfoundation.org",
      "industry": "Non-profit Organizations",
      "industries": ["Non-profit Organizations"],
      "company_size": "1001-5000",
      "headcount": null,
      "headquarters": {
        "city": null,
        "state": null,
        "country": null,
        "country_code": null,
        "raw": "Seattle, WA"
      },
      "company_description": null,
      "company_keywords": null,
      "company_logo": null,
      "follower_count": null,
      "year_founded": null,
      "organization_type": null,
      "linkedin_id": "8736"
    }
  },
  "credits_used": 0.2,
  "credits_remaining": 4822.8,
  "success": true
}

Output: Full profile

{
  "status": "success",
  "data": {
    "profile": {
      "person_name": "Bill Gates",
      "first_name": "Bill",
      "last_name": "Gates",
      "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
      "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "city": "Seattle",
      "state": "Washington",
      "country": "United States",
      "country_code": "us",
      "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
      "open_to_work": false,
      "follower_count": 40527040,
      "connection_count": 8,
      "work_experience": [
        {
          "company_name": "Gates Foundation",
          "current_title": "Co-chair",
          "location": null,
          "start_date": "2000",
          "end_date": null,
          "is_current": true,
          "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
          "description": null,
          "employment_type": null
        }
      ],
      "education_history": [
        {
          "school_name": "Harvard University",
          "degree": null,
          "field_of_study": null,
          "start_date": "1973",
          "end_date": "1975",
          "school_linkedin_url": null
        }
      ],
      "skills": [],
      "profile_picture_url": null,
      "linkedin_id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"
    },
    "company": {
      "organization_name": "Gates Foundation",
      "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation",
      "company_website": "https://www.gatesfoundation.org/about/careers",
      "domain": "gatesfoundation.org",
      "industry": "Non-profit Organizations",
      "industries": ["Non-profit Organizations"],
      "company_size": "1001-5000",
      "headcount": 4223,
      "headquarters": {
        "city": null,
        "state": null,
        "country": null,
        "country_code": "us",
        "raw": "Seattle, WA"
      },
      "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": "8736"
    }
  },
  "credits_used": 0.4,
  "credits_remaining": 4822.6,
  "success": true
}

Output: Still running

{
  "status": "processing",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "The lookup is still running and is being collected in the background. Call again shortly and the record will be returned.",
  "success": true
}

Error

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

Related

• Batch Lookup: up to 10 URLs in one call.

• List Lookup: a whole Parvenu list.