Get companies in batch

Fetch up to 50 companies in one call: GET /api/v1/company once per entry, with the same company object for each one found and a per-entry error for the others, in input order. The response is 200 even when some or all entries failed - read found or each entry's error. Billing: 1 credit per company returned; not-found and failed entries are free. The balance is checked for the whole batch (one credit per distinct entry) before any work, otherwise 402 QUOTA_EXHAUSTED. Validation errors are 400 and free. Rate limit: the batch uses your plan's per-second limit - the request takes one unit and each company after the first consumes one more from the same budget, waiting for it when the window is full, so a 50-company batch on a 5 req/s plan takes about 10 seconds. Entries that could not be fetched within 90 seconds come back with an error RATE_LIMITED (status 429) and are not billed.

post/api/v1/company/batch

Request

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

Request body

companiesstring[] required

1 to 50 companies, each a company page URL, a public identifier (universal name, e.g. microsoft) or a URN (urn:li:fsd_company:1035). Duplicates (same text, case-insensitive) are fetched, billed and returned once. Refused with a free 400: not an array or empty ('companies' must be an array of 1 to 50 company URLs, public identifiers or URNs.), more than 50 entries ('companies' accepts at most 50 entries (received N).), an entry that is not a non-empty string ('companies[i]' must be a non-empty string.).

Example request

{
  "companies": [
    "https://www.linkedin.com/company/doctolib",
    "microsoft",
    "urn:li:fsd_company:1441"
  ]
}

Response

One result per distinct input, in input order. Billed 1 credit per entry returned with a company.

foundinteger required

Entries returned with a company - the credits billed.

notFoundinteger required

Entries whose error has status 404.

failedinteger required

Every other error: rate limit, invalid entry, failure on our side.

Example response

{
  "results": [
    {
      "company": {
        "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"
        ]
      },
      "error": {
        "code": "COMPANY_NOT_FOUND",
        "status": 404
      }
    }
  ]
}

Changes

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