---
title: "Search companies on LinkedIn"
method: GET
path: "/linkedin/companies"
tags: ["LinkedIn"]
---

# Search companies on LinkedIn

`GET /linkedin/companies`

## Request

- Base URL: `https://api.scrapefield.com/v1`
- URL: `https://api.scrapefield.com/v1/linkedin/companies`
- Auth: one of:
  - HTTP bearer
  - none

Find companies by name or keywords, place and size, up to 50 a page. Each result has the company's id, page, industry, place and followers; linkedin/company gives the whole page, and linkedin/employees its people.

Costs 7 credits, whether the answer is fetched or served from cache. A failed call is refunded automatically.

## Query parameters

- `query` string, required
- `location` string
- `company_size` string
- `cursor` string
- `fresh` boolean
- `demo` boolean

## Response `200`

The request succeeded.

- object
  - `data` LinkedinCompanyResult[], required
    - `company_id` string, required: LinkedIn's numeric id for the company: linkedin/employees, linkedin/employee-stats, linkedin/jobs and linkedin/ads take it as `company_id`, and linkedin/people as a filter.
    - `vanity_name` string, nullable, required: The part after `/company/` in the page URL.
    - `url` string, uri, required: The company page.
    - `name` string, required: The company's name.
    - `industry` string, nullable, required: As the search prints it.
    - `location` string, nullable, required: As the search prints it.
    - `follower_count` integer, nullable, required: `null` where LinkedIn prints a rounded number, such as "12K followers".
    - `summary` string, nullable, required: The line the search shows under the name.
    - `logo_url` string, uri, nullable, required: The company's logo.
  - `meta` Meta, required
    - `request_id` string, required: Quote this if you contact support.
    - `credits_charged` integer, required: The endpoint's published cost. 0 for a demo answer, and for a list emptied because everyone in it asked not to be served. A failed call has no `meta`: it answers with an error, and is refunded.
    - `credits_remaining` integer
    - `cached` boolean, required
    - `fetched_at` string, date-time, required: When the data was actually fetched — the original time on a cache hit, so freshness is always visible.
    - `next_cursor` string, nullable, required: Pass as `cursor` for the next page. `null` on the last page. It lasts as long as the answer is cached.
    - `demo` boolean: Present, and true, on a demo answer (`?demo=true` with no key).
    - `note` string: On a demo answer: what it is, and what a live call costs.

## Other responses

- `400`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `401`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `403`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `404`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `429`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `500`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `501`: Something went wrong. `error.code` is stable; `error.message` says what to do next.
- `502`: Something went wrong. `error.code` is stable; `error.message` says what to do next.

---

[API](https://skmtc.dev/scrapefield/apis/scrapefield-api.md) · [All operations](https://skmtc.dev/scrapefield/apis/scrapefield-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapefield/apis/scrapefield-api/revisions/cc5961ac63cf?raw)