Get Company - Fetchin API

Get company

curl --request GET \
  --url https://api.fetchin.io/api/v1/company \
  --header 'X-API-Key: <api-key>'

{
  "id": "urn:li:fsd_company:4999584",
  "companyId": "4999584",
  "name": "Doctolib",
  "publicIdentifier": "doctolib",
  "url": "https://www.linkedin.com/company/doctolib/",
  "websiteUrl": "https://careers.doctolib.com/",
  "domain": "careers.doctolib.com",
  "industry": "Computer Software",
  "employeeCount": 3714,
  "employeeCountRange": { "start": 1001, "end": 5000 },
  "headquarter": {
    "line1": "54, Quai Charles Pasqua",
    "city": "Levallois-Perret",
    "geographicArea": "Île-de-France",
    "postalCode": "92300",
    "country": "FR",
    "description": "Siège social",
    "headquarter": true
  },
  "locations": [
    {
      "city": "Levallois-Perret",
      "geographicArea": "Île-de-France",
      "country": "FR",
      "headquarter": true
    }
  ],
  "followerCount": 323490,
  "logoUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "description": "We're a B Corp company committed to build together the healthcare we all dream of.",
  "specialities": ["Santé", "e-health", "telehealth", "online appointments"]
}

GET

api

company

Get company

curl --request GET \
  --url https://api.fetchin.io/api/v1/company \
  --header 'X-API-Key: <api-key>'

{
  "id": "urn:li:fsd_company:4999584",
  "companyId": "4999584",
  "name": "Doctolib",
  "publicIdentifier": "doctolib",
  "url": "https://www.linkedin.com/company/doctolib/",
  "websiteUrl": "https://careers.doctolib.com/",
  "domain": "careers.doctolib.com",
  "industry": "Computer Software",
  "employeeCount": 3714,
  "employeeCountRange": { "start": 1001, "end": 5000 },
  "headquarter": {
    "line1": "54, Quai Charles Pasqua",
    "city": "Levallois-Perret",
    "geographicArea": "Île-de-France",
    "postalCode": "92300",
    "country": "FR",
    "description": "Siège social",
    "headquarter": true
  },
  "locations": [
    {
      "city": "Levallois-Perret",
      "geographicArea": "Île-de-France",
      "country": "FR",
      "headquarter": true
    }
  ],
  "followerCount": 323490,
  "logoUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "description": "We're a B Corp company committed to build together the healthcare we all dream of.",
  "specialities": ["Santé", "e-health", "telehealth", "online appointments"]
}

Endpoint

GET /api/v1/company

Authentication

Include your API key in the request header:

X-API-Key: your-api-key-here

Parameters

companyUrlOrUrn

string

required

The company / organization to fetch. Accepts any of:

Company URL. Example: https://www.linkedin.com/company/doctolib (a trailing slash makes no difference). School and showcase page URLs work too.
Public identifier (slug), also fine. Example: doctolib
Company URN. Example: urn:li:fsd_company:4999584

The slug is the last path segment of a company URL (linkedin.com/company/<slug>). Pass just the slug, not the /company/ prefix.Member profile inputs (a /in/<slug> URL or a urn:li:fsd_profile:…) are rejected with INVALID_PARAMETER — use Get Profile for people.

Response

company

object

Company / organization information

Show Company object

string

Company URN (unique identifier), e.g. “urn:li:fsd_company:4999584”

companyId

string

Numeric company id as a string, e.g. “4999584”

name

string

Company name, e.g. “Doctolib”

publicIdentifier

string

Public identifier (slug), e.g. “doctolib”

url

string

Canonical company page URL

websiteUrl

string

The company’s own website (optional)

domain

string

Website domain, derived from websiteUrl with any leading www. removed, e.g. “doctolib.com” (optional)

industry

string

Primary industry, e.g. “Computer Software” (optional)

employeeCount

number

Number of employees on the platform (optional)

employeeCountRange

object

Employee count bracket (optional)

Show EmployeeCountRange object

start

number

Lower bound, e.g. 1001

end

number

Upper bound, e.g. 5000 (absent for open-ended brackets like “10,001+”)

foundedOn

object

Founding date (optional; only year is guaranteed when present)

Show FoundedOn object

year

number

Year, e.g. 2010

month

number

Month (1-12), when available

day

number

Day of month, when available

headquarter

object

Headquarters address (optional)

Show Address object

line1

string

Street address line 1

line2

string

Street address line 2

city

string

City, e.g. “Levallois-Perret”

geographicArea

string

State / region, e.g. “Île-de-France”

postalCode

string

Postal code

country

string

ISO country code, e.g. “FR”

description

string

Office label, e.g. “Headquarters”

headquarter

boolean

true for the headquarters entry

locations

array

All known office locations (optional). Each entry has the same shape as headquarter.

followerCount

number

Number of followers (optional)

logoUrl

string

Company logo image URL

coverImageUrl

string

Company cover/background image URL (optional)

description

string

Company “About” description (optional)

specialities

array

Specialities / focus areas (string array, optional)

phone

string

Public contact phone number (optional)

tagline

string

Company tagline (optional)

Example Request

curl -X GET "https://api.fetchin.io/api/v1/company?companyUrlOrUrn=https://www.linkedin.com/company/doctolib" \
  -H "X-API-Key: your-api-key-here"

Example Response

{
  "id": "urn:li:fsd_company:4999584",
  "companyId": "4999584",
  "name": "Doctolib",
  "publicIdentifier": "doctolib",
  "url": "https://www.linkedin.com/company/doctolib/",
  "websiteUrl": "https://careers.doctolib.com/",
  "domain": "careers.doctolib.com",
  "industry": "Computer Software",
  "employeeCount": 3714,
  "employeeCountRange": { "start": 1001, "end": 5000 },
  "headquarter": {
    "line1": "54, Quai Charles Pasqua",
    "city": "Levallois-Perret",
    "geographicArea": "Île-de-France",
    "postalCode": "92300",
    "country": "FR",
    "description": "Siège social",
    "headquarter": true
  },
  "locations": [
    {
      "city": "Levallois-Perret",
      "geographicArea": "Île-de-France",
      "country": "FR",
      "headquarter": true
    }
  ],
  "followerCount": 323490,
  "logoUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "description": "We're a B Corp company committed to build together the healthcare we all dream of.",
  "specialities": ["Santé", "e-health", "telehealth", "online appointments"]
}

Errors

See Error Handling for the full list of error codes and recommended handling.

400 MISSING_PARAMETER / INVALID_PARAMETER / INVALID_URN
401 INVALID_API_KEY
404 COMPANY_NOT_FOUND
429 RATE_LIMITED / QUOTA_EXHAUSTED
500 INTERNAL_ERROR
503 SERVICE_UNAVAILABLE

Notes

This endpoint consumes 1 credit from your monthly quota. Failed requests (errors) do not count against your quota.

Company data is fetched in real-time from professional data sources. Response times may vary. A 503 SERVICE_UNAVAILABLE is safe to retry after a short delay.

Most fields beyond name, companyId, and publicIdentifier are optional — a company page may simply not list a phone number, tagline, or founding date. Always guard for missing keys.

Use Cases

Account enrichment

Enrich your CRM with firmographic data: size, industry, HQ, website

Lead scoring

Segment and score accounts by employee count, industry, and location

Market research

Analyze competitors and market segments by company attributes

Data completion

Fill gaps in vendor and partner records from a professional profile URL

Authorizations

X-API-Key

string

header

required

Query Parameters

companyUrlOrUrn

string

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

string

Company URN (unique identifier)

Example:

"urn:li:fsd_company:4999584"

companyId

string

Numeric company id as a string

Example:

"4999584"

name

string

Example:

"Doctolib"

publicIdentifier

string

Public identifier (slug)

Example:

"doctolib"

url

string

Canonical company page URL

Example:

"https://www.linkedin.com/company/doctolib/"

websiteUrl

string

The company's own website

domain

string

Website domain, minus a leading www.

Example:

"doctolib.com"

industry

string

Example:

"Computer Software"

employeeCount

number

Number of employees on the platform

employeeCountRange

object

Show child attributes

foundedOn

object

Show child attributes

headquarter

object

Show child attributes

locations

object[]

Show child attributes

followerCount

number

logoUrl

string

coverImageUrl

string

Cover/background image URL

description

string

specialities

string[]

phone

string

tagline

string

Get Profile Reactions

​Endpoint

​Authentication

​Parameters

​Response

​Example Request

​Example Response

​Errors

​Notes

​Use Cases

Account enrichment

Lead scoring

Market research

Data completion

Authorizations

Query Parameters

Response

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Use Cases