Enrich a Company by LinkedIn URL or Domain

GET

company-enrichment

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?linkedin_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fkearney" \
  --header "X-API-Key: <api-key>"

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?domain=kearney.com" \
  --header "X-API-Key: <api-key>"

import requests

response = requests.get(
    "https://api.orbisearch.com/v1/company-enrichment",
    params={"linkedin_url": "https://www.linkedin.com/company/kearney"},
    # or: params={"domain": "kearney.com"},
    headers={"X-API-Key": "<api-key>"},
)
print(response.json())

const url = new URL("https://api.orbisearch.com/v1/company-enrichment");
url.searchParams.set("linkedin_url", "https://www.linkedin.com/company/kearney");
// or: url.searchParams.set("domain", "kearney.com");

const response = await fetch(url, {
  headers: { "X-API-Key": "<api-key>" },
});
console.log(await response.json());

{
  "result": "found",
  "input": "https://www.linkedin.com/company/kearney",
  "linkedin_url": "https://www.linkedin.com/company/kearney",
  "linkedin_id": 2196,
  "name": "Kearney",
  "description": "As one of the original firms, we've never lost sight…",
  "website": "https://www.kearney.com/",
  "domain": "kearney.com",
  "email_domain": "kearney.com",
  "industry": "Business Consulting and Services",
  "company_size": {
    "label": "5,001-10,000 employees",
    "min": 5001,
    "max": 10000
  },
  "employee_count": 7548,
  "company_type": "Partnership",
  "headquarters": {
    "text": "Chicago, Illinois",
    "city": "Chicago",
    "region": "Illinois",
    "country": "US"
  },
  "founded_year": 1926,
  "specialties": [
    "Management Consulting"
  ],
  "follower_count": 694285,
  "similar_companies": [
    {
      "name": "Oliver Wyman",
      "linkedin_url": "https://www.linkedin.com/company/oliver-wyman",
      "industry": "Business Consulting and Services",
      "location": "New York, NY"
    }
  ],
  "is_redirect": false,
  "credits_consumed": 1
}

{
  "detail": "API key required in X-API-Key header"
}

{
  "detail": "Insufficient credits. You have 0.15 credits but need 0.2."
}

{
  "detail": "Missing required query parameter: email.",
  "errors": [
    {
      "loc": "query.email",
      "msg": "Missing required query parameter: email.",
      "type": "missing"
    }
  ]
}

{
  "detail": "Rate limit exceeded. Maximum 20 requests per second per API key. Contact us to discuss higher limits.",
  "code": "rate_limited"
}

{
  "detail": "Company enrichment service temporarily unavailable"
}

{
  "detail": "Company enrichment is not available in this environment"
}

Use this endpoint when you have a company’s LinkedIn URL or its website domain and want structured data about the company. OrbiSearch returns the company’s name, description, website and registrable domain, industry, size bucket, exact employee_count and follower_count, company type, headquarters, founded year, specialties, and similar companies. This endpoint is credit-metered and needs a pay-as-you-go API key. It is not part of the unlimited plans. The response returns result: found with the company’s data, or result: not_found when no company matches the LinkedIn URL, or no company matches the domain. On not_found, every data field is null (or an empty list for specialties and similar_companies).

LinkedIn URL or domain

Send exactly one of these query parameters:

linkedin_url: the company’s LinkedIn page. Use this whenever you have it. It names the company directly, so it gives the best results.
domain: the company’s website domain, such as kearney.com. OrbiSearch matches it to the company and returns the same record, including the company’s LinkedIn URL. Use it when you don’t have the LinkedIn URL.

Sending both, or neither, is rejected with 422 before any charge.

Accepted LinkedIn URLs

Send the company’s LinkedIn URL as the linkedin_url query parameter. Company pages (/company/<name>) and showcase pages (/showcase/<name>) are both accepted. The URL can be written the way it was copied: with or without https:// and www, on a country subdomain such as uk.linkedin.com, or with a trailing path or query string such as /about/ or ?trk=.... These are rejected with 422 before any charge:

A URL that isn’t a LinkedIn company or showcase page, such as a person’s profile (/in/...) or a job listing.
A numeric company URL such as linkedin.com/company/1035. Use the company’s name URL instead, for example linkedin.com/company/kearney.
A company name longer than 200 characters, or one containing characters that can’t be part of a LinkedIn URL.

Accepted domains

Send the company’s website as the domain query parameter. A bare domain (kearney.com), a subdomain (www.kearney.com) or a full URL (https://www.kearney.com/about) all work: OrbiSearch reduces it to the registrable domain, kearney.com. A search by domain only returns a company whose own website is on that domain. If the website redirects to another domain, for example after a rebrand, a company whose website is on the new domain counts too. The response then has is_redirect: true, and redirected_to names the domain it redirects to. Both are always false and null on a search by LinkedIn URL. On a search by domain that finds no company, linkedin_url is null as well as the data fields. input always echoes what you sent. These are rejected with 422 before any charge:

A LinkedIn URL sent as domain. Send it as linkedin_url instead.
A value that isn’t a website domain, or a site on a shared website-builder address rather than its own domain.

Pricing and refunds

Each request costs 1 credit.
Every returned response is charged, found and not_found alike, by LinkedIn URL or by domain, including repeat requests for the same company.
Refunds are issued only when OrbiSearch infrastructure cannot complete the request (502). Retry the request.
A request rejected with 422 is never charged.

For more than a handful of companies, use bulk company enrichment. Duplicate inputs within a job are charged once.

Rate limits

This endpoint shares the 20 requests per second per API key limit with the rest of the /v1/* API. Exceeding it returns a 429 Too Many Requests response. See errors for how to handle rate limit responses.

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?linkedin_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fkearney" \
  --header "X-API-Key: <api-key>"

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?domain=kearney.com" \
  --header "X-API-Key: <api-key>"

import requests

response = requests.get(
    "https://api.orbisearch.com/v1/company-enrichment",
    params={"linkedin_url": "https://www.linkedin.com/company/kearney"},
    # or: params={"domain": "kearney.com"},
    headers={"X-API-Key": "<api-key>"},
)
print(response.json())

const url = new URL("https://api.orbisearch.com/v1/company-enrichment");
url.searchParams.set("linkedin_url", "https://www.linkedin.com/company/kearney");
// or: url.searchParams.set("domain", "kearney.com");

const response = await fetch(url, {
  headers: { "X-API-Key": "<api-key>" },
});
console.log(await response.json());

Authorizations

X-API-Key

string

header

required

API key for authentication

Query Parameters

linkedin_url

string | null

A LinkedIn company or showcase URL. Preferred. Send this or domain, not both.

Example:

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

domain

string | null

The company's website domain, or a full URL reduced to its domain. Send this or linkedin_url, not both.

Example:

"kearney.com"

Response

Successful Response

Enriched public record for a company, by LinkedIn URL or website domain.

result

enum<string>

required

found (a company record is returned) or not_found (no company matches the URL or the domain; all data fields are null).

Available options:

found,

not_found

input

string

required

The linkedin_url or domain you sent, verbatim.

Example:

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

credits_consumed

number

required

Credits charged for this attempt (1).

Example:

1

linkedin_url

string | null

The company's LinkedIn URL, normalized. Null when a search by domain finds no company.

Example:

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

linkedin_id

integer | null

Stable numeric company ID. Null for not_found.

Example:

2196

name

string | null

Company name.

Example:

"Kearney"

description

string | null

Full company description (not truncated).

website

string | null

Website the company lists.

Example:

"https://www.kearney.com/"

domain

string | null

The company's website domain. Null when the company has no website of its own.

Example:

"kearney.com"

email_domain

string | null

The domain the company hosts its email on. Null when there's no domain.

Example:

"kearney.com"

industry

string | null

Industry label.

Example:

"Business Consulting and Services"

company_size

CompanySizeBucket · object | null

The company's self-reported headcount range.

Show child attributes

employee_count

integer | null

Estimated headcount.

Example:

7548

company_type

string | null

Company type (Privately held, Public company, …).

Example:

"Partnership"

headquarters

CompanyHeadquarters · object | null

Headquarters location.

Show child attributes

founded_year

integer | null

Year founded.

Example:

1926

specialties

string[]

Specialties the company lists. Empty when unknown.

Example:

["Management Consulting"]

follower_count

integer | null

Exact follower count.

Example:

694285

similar_companies

SimilarCompany · object[]

Companies similar to this one. Empty when unknown.

Show child attributes

is_redirect

boolean

default:false

Searches by domain: true when the domain you sent redirects to another website. Always false for a search by LinkedIn URL.

Example:

false

redirected_to

string | null

Searches by domain: the website domain your domain redirects to, or null. Always null for a search by LinkedIn URL.

Example:

null

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?linkedin_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fkearney" \
  --header "X-API-Key: <api-key>"

curl --request GET \
  --url "https://api.orbisearch.com/v1/company-enrichment?domain=kearney.com" \
  --header "X-API-Key: <api-key>"

import requests

response = requests.get(
    "https://api.orbisearch.com/v1/company-enrichment",
    params={"linkedin_url": "https://www.linkedin.com/company/kearney"},
    # or: params={"domain": "kearney.com"},
    headers={"X-API-Key": "<api-key>"},
)
print(response.json())

const url = new URL("https://api.orbisearch.com/v1/company-enrichment");
url.searchParams.set("linkedin_url", "https://www.linkedin.com/company/kearney");
// or: url.searchParams.set("domain", "kearney.com");

const response = await fetch(url, {
  headers: { "X-API-Key": "<api-key>" },
});
console.log(await response.json());

{
  "result": "found",
  "input": "https://www.linkedin.com/company/kearney",
  "linkedin_url": "https://www.linkedin.com/company/kearney",
  "linkedin_id": 2196,
  "name": "Kearney",
  "description": "As one of the original firms, we've never lost sight…",
  "website": "https://www.kearney.com/",
  "domain": "kearney.com",
  "email_domain": "kearney.com",
  "industry": "Business Consulting and Services",
  "company_size": {
    "label": "5,001-10,000 employees",
    "min": 5001,
    "max": 10000
  },
  "employee_count": 7548,
  "company_type": "Partnership",
  "headquarters": {
    "text": "Chicago, Illinois",
    "city": "Chicago",
    "region": "Illinois",
    "country": "US"
  },
  "founded_year": 1926,
  "specialties": [
    "Management Consulting"
  ],
  "follower_count": 694285,
  "similar_companies": [
    {
      "name": "Oliver Wyman",
      "linkedin_url": "https://www.linkedin.com/company/oliver-wyman",
      "industry": "Business Consulting and Services",
      "location": "New York, NY"
    }
  ],
  "is_redirect": false,
  "credits_consumed": 1
}

{
  "detail": "API key required in X-API-Key header"
}

{
  "detail": "Insufficient credits. You have 0.15 credits but need 0.2."
}

{
  "detail": "Missing required query parameter: email.",
  "errors": [
    {
      "loc": "query.email",
      "msg": "Missing required query parameter: email.",
      "type": "missing"
    }
  ]
}

{
  "detail": "Rate limit exceeded. Maximum 20 requests per second per API key. Contact us to discuss higher limits.",
  "code": "rate_limited"
}

{
  "detail": "Company enrichment service temporarily unavailable"
}

{
  "detail": "Company enrichment is not available in this environment"
}

Email validation (credits)

Email finder (credits)

Email finder (unlimited)

Company enrichment (credits)

Deliverability

Account

Reference

Enrich a Company by LinkedIn URL or Domain

LinkedIn URL or domain

Accepted LinkedIn URLs

Accepted domains

Pricing and refunds

Rate limits

Authorizations

Query Parameters

Response

​LinkedIn URL or domain

​Accepted LinkedIn URLs

​Accepted domains

​Pricing and refunds

​Rate limits

Authorizations

Query Parameters

Response

LinkedIn URL or domain

Accepted LinkedIn URLs

Accepted domains

Pricing and refunds

Rate limits