Get Company

Get company

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

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/company",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/company"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/company")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": "Software Development",
  "industryV1": "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"]
}

{
  "error": "Missing companyUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "companyUrlOrUrn must reference a company, not a member profile",
  "code": "INVALID_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Unable to find company data from slug",
  "code": "COMPANY_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

GET

api

company

Get company

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

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/company', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/company",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/company"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/company")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": "Software Development",
  "industryV1": "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"]
}

{
  "error": "Missing companyUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "companyUrlOrUrn must reference a company, not a member profile",
  "code": "INVALID_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Unable to find company data from slug",
  "code": "COMPANY_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

Endpoint

GET /api/v1/company

Authentication

Include your API key in the request header:

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

Parameters

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

object

Company / organization information

Show Company object

string

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

string

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

string

Company name, e.g. “Doctolib”

string

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

string

Canonical company page URL

string

The company’s own website (optional)

string

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

string

Primary industry in the current taxonomy, matching the label shown on the company’s public page, e.g. “Software Development” (optional)

string

The same company’s industry in the legacy taxonomy, e.g. “Computer Software” (optional).Provided only for integrations that pinned the older labels. It is not a renaming of industry: a company can sit under two unrelated entries in the two taxonomies, so industryV1 must not be used as a translation table. Prefer industry.

number

Number of employees on the platform (optional)

object

Employee count bracket (optional)

Show EmployeeCountRange object

number

Lower bound, e.g. 1001

number

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

object

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

Show FoundedOn object

number

Year, e.g. 2010

number

Month (1-12), when available

number

Day of month, when available

object

Headquarters address (optional)

Show Address object

string

Street address line 1

string

Street address line 2

string

City, e.g. “Levallois-Perret”

string

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

string

Postal code

string

ISO country code, e.g. “FR”

string

Office label, e.g. “Headquarters”

boolean

true for the headquarters entry

array

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

number

Number of followers (optional)

string

Company logo image URL

string

Company cover/background image URL (optional)

string

Company “About” description (optional)

array

Specialities / focus areas (string array, optional)

string

Public contact phone number (optional)

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"

const response = await fetch(
  'https://api.fetchin.io/api/v1/company?companyUrlOrUrn=https://www.linkedin.com/company/doctolib',
  {
    headers: {
      'X-API-Key': 'your-api-key-here'
    }
  }
);

const company = await response.json();
console.log(company);

import requests

headers = {
    'X-API-Key': 'your-api-key-here'
}

params = {
    'companyUrlOrUrn': 'https://www.linkedin.com/company/doctolib'
}

response = requests.get(
    'https://api.fetchin.io/api/v1/company',
    headers=headers,
    params=params
)

company = response.json()
print(company)

<?php

$apiKey = 'your-api-key-here';
$companyUrl = 'https://www.linkedin.com/company/doctolib';

$url = "https://api.fetchin.io/api/v1/company?companyUrlOrUrn=" . urlencode($companyUrl);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey
]);

$response = curl_exec($ch);
$company = json_decode($response, true);

curl_close($ch);
print_r($company);
?>

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": "Software Development",
  "industryV1": "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"]
}

{
  "error": "Missing companyUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "companyUrlOrUrn must reference a company, not a member profile",
  "code": "INVALID_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "Unable to find company data from slug",
  "code": "COMPANY_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

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
402 QUOTA_EXHAUSTED
429 RATE_LIMITED
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

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

Example:

"Software Development"

industryV1

string

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.

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

Getting Started

Core Concepts

Apify Compatibility

Account

Posts

Profile

Company

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

Account enrichment

Lead scoring

Market research

Data completion

Authorizations

Query Parameters

Response

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Use Cases