---
title: "Search companies in LinkFetch's dataset by name, industry, HQ country and minimum size."
method: GET
path: "/v1/companies"
tags: ["Jobs and companies"]
---

# Search companies in LinkFetch's dataset by name, industry, HQ country and minimum size.

`GET /v1/companies`

## Request

- Base URL: `https://linkfetch.io`
- URL: `https://linkfetch.io/v1/companies`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Search companies in LinkFetch's dataset by name, industry, HQ country and minimum size.

1 credit per request, however many rows come back.

MCP tool: `search_companies`.

## Query parameters

- `q` string
- `industry` string
- `country` string[]
- `size` integer
- `hiring` '1'
- `profiled` '1'
- `limit` integer
- `page` integer
- `offset` integer

## Response `200`

OK

- object
  - `total` integer
  - `total_capped` boolean: True when total stopped counting at a cap.
  - `page` integer
  - `limit` integer
  - `data` CompanyListItem[]
    - `id` integer
    - `name` string
    - `slug` string
    - `linkedin_url` string, uri
    - `logo_url` string, nullable
    - `industry` string, nullable
    - `size` object
      - `min` integer, nullable
      - `max` integer, nullable
    - `linkedin_members` integer, nullable
    - `headquarters` object
      - `city` string, nullable
      - `country_code` string, nullable
    - `website` string, nullable
    - `jobs_last_30_days` integer
    - `last_job_seen_at` string, date-time, nullable

## Other responses

- `400`: Invalid input (`bad_request`).
- `401`: Missing, invalid or revoked API key (`unauthorized`).
- `402`: Out of credits (`out_of_credits`).
- `default`: Other errors: 409 account session needs attention, 428 no connected account (`no_account`), 501 not in the API yet (`coming_soon`), 502 LinkedIn failed (`upstream`), 503 `unavailable`, 500 `internal`.

---

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