Individual Lookup

Fetch one LinkedIn company profile by company URL. Synchronous, returns the profile directly.

POST /company_profile

Costs 0.1 credit per call. Returns the profile directly in the response, no list and no polling. Pass listname and a company already checked on that list recently comes back at 0 credits.

The field is company_linkedin_url. The older company_url name is no longer accepted and returns a 422.

Pass a LinkedIn company URL. The response contains the profile in data.

Reusing a recent lookup. If the company belongs to one of your lists, pass that list as listname. When the company was already checked and charged on that list recently (by this endpoint, a Flow, or a list enrichment from the app, the API or the connector), the saved record is returned straight away with credits_used: 0 and a message saying when it was checked. Otherwise it is looked up and charged as usual, and kept so a later call can reuse it. Without listname every call is looked up and charged.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
company_linkedin_url	string	The LinkedIn company URL to look up.
listname	string	Optional. A list the company is on. A company checked on that list recently is not charged again.

Response

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

Field	Description
organization_name	Company name.
company_linkedin_url	LinkedIn company page URL.
company_website	Website as LinkedIn lists it.
domain	Bare domain taken from that website.
industry	Primary industry.
industries	All industries, as an array.
company_size	Employee band, e.g. 10001+.
headcount	Employee count LinkedIn shows, when it is a number.
headquarters	Object with city, state, country, country_code and raw.
company_description	The company's About text.
company_keywords	LinkedIn's Specialties line, split into an array.
company_logo	Logo image URL.
follower_count	LinkedIn followers.
year_founded	Founding year, when given.
organization_type	E.g. Public Company.
linkedin_id	LinkedIn's own identifier for the company.

Anything the source returns that has no canonical name is kept under extra. A record reused from a list enrichment carries the fields that enrichment saves (name, LinkedIn URL, website, industry, size, headcount, description and keywords).

A lookup that is still running answers with status: "processing". Some company pages take longer to collect than the request can wait for, so the API hands back "status": "processing", "data": null and a message telling you to call again shortly. The collection continues in the background, so repeat the same request a moment later and the record comes back with "status": "success".

Example

Input

{
  "api_key": "your_api_key",
  "company_linkedin_url": "https://www.linkedin.com/company/microsoft",
  "listname": "Pantheon Attendees 2026"
}

Output

{
  "status": "success",
  "data": {
    "organization_name": "Microsoft",
    "company_linkedin_url": "https://www.linkedin.com/company/microsoft",
    "company_website": "https://news.microsoft.com/",
    "domain": "news.microsoft.com",
    "industry": "Software Development",
    "industries": ["Software Development"],
    "company_size": "10001+",
    "headcount": 233176,
    "headquarters": {
      "city": null,
      "state": null,
      "country": null,
      "country_code": null,
      "raw": "Redmond, Washington"
    },
    "company_description": "Microsoft | 28,682,470 followers on LinkedIn. Every company has a mission...",
    "company_keywords": [
      "Business Software",
      "Developer Tools",
      "Home & Educational Software",
      "Tablets",
      "Search",
      "Advertising"
    ],
    "company_logo": null,
    "follower_count": 28682470,
    "year_founded": null,
    "organization_type": "Public Company",
    "linkedin_id": "microsoft"
  },
  "credits_used": 0.1,
  "credits_remaining": 4005.2,
  "success": true
}

Reused (0 credits)

{
  "status": "success",
  "data": {
    "organization_name": "Microsoft",
    "company_linkedin_url": "https://www.linkedin.com/company/microsoft",
    "headcount": 231728
  },
  "credits_used": 0,
  "credits_remaining": 4005.1,
  "message": "Company checked 10-06-26 on this list, not charged again",
  "success": true
}

Still running

{
  "status": "processing",
  "data": null,
  "credits_used": 0.1,
  "credits_remaining": 4005.2,
  "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": "not_found",
    "message": "Not Found"
  },
  "success": false
}

To look up every company in a list in one call instead, use List Lookup.