Get company

Get detailed information about a company / organization. Consumes 1 credit.

get/api/v1/company

Request

  • Base URL: https://api.fetchin.io
  • URL: https://api.fetchin.io/api/v1/company
  • Auth: API key in header X-API-Key

Query parameters

companyUrlOrUrnstring required

The company / organization to fetch. Accepts a company page URL (example https://www.linkedin.com/company/doctolib; school and showcase URLs work too), a public identifier/slug (example doctolib), or a company URN (example urn:li:fsd_company:4999584). Member profile inputs (a /in/<slug> URL or a urn:li:fsd_profile:…) are rejected with INVALID_PARAMETER.

Response

Successfully fetched company

idstring

Company URN (unique identifier)

companyIdstring

Numeric company id as a string

namestring
publicIdentifierstring

Public identifier (slug)

urlstring

Canonical company page URL

websiteUrlstring

The company's own website

domainstring

Website domain, minus a leading www.

industrystring

Primary industry in the current taxonomy, matching the label shown on the company's public page

industryV1string

The same company's industry in the legacy taxonomy, for integrations that pinned the older labels. Not a renaming of industry: a company can sit under two unrelated entries in the two taxonomies, so this must not be used as a translation table. Prefer industry.

employeeCountnumber

Number of employees on the platform

followerCountnumber
logoUrlstring
coverImageUrlstring

Cover/background image URL

descriptionstring
specialitiesstring[]
phonestring
taglinestring
companyTypestring

The company's legal type as an English label, e.g. "Public Company", "Privately Held", "Self-Employed", "Sole Proprietorship", "Partnership", "Government Agency", "Nonprofit", "Educational".

companyTypeCodestring

The same type as a stable code, e.g. "PUBLIC_COMPANY", "PRIVATELY_HELD". Branch on this rather than on the label.

hashtagsstring[]

Hashtags the page lists on its profile, in its order, without the #.

Example response

{
  "id": "urn:li:fsd_company:4999584",
  "companyId": "4999584",
  "name": "Doctolib",
  "publicIdentifier": "doctolib",
  "url": "https://www.linkedin.com/company/doctolib/",
  "domain": "doctolib.com",
  "industry": "Software Development",
  "industryV1": "Computer Software",
  "headquarter": {
    "city": "Levallois-Perret",
    "geographicArea": "Île-de-France",
    "country": "FR"
  },
  "locations": [
    {
      "city": "Levallois-Perret",
      "geographicArea": "Île-de-France",
      "country": "FR"
    }
  ],
  "companyType": "Privately Held",
  "companyTypeCode": "PRIVATELY_HELD",
  "hashtags": [
    "microsoftlife",
    "microsoft"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.