Read-only

List and Export Companies

Query and export companies from your account with rich filtering by industry, headcount range, location, tags, custom attributes, or external IDs, and optionally scope to a company list. Results return as JSON or as CSV when format='csv', with cursor-based pagination. Returns an empty array when no companies match.

list_companiesGET/api/v1/companies
crispy — bash

Example prompt: Export all my companies in software with 50 to 500 employees in the UK as CSV

[
  {
    "id": "co_8821",
    "name": "Acme Analytics",
    "industry": ["Software"],
    "headcount": 180,
    "location": "London, UK"
  }
]
Permission scope
read only, core
Access
Read-only
Category
Search & Discovery

What you can build

Export a filtered company list to CSV for reporting or handoff to your CRM
Find companies that have at least one contact in your network for warm intros
Filter accounts by industry and headcount to build a focused target list
Look up companies by external CRM IDs or custom attributes for syncing

Parameters

Inputs accepted by list_companies.

NameTypeDescription
list_idstringScope to a company list (kind='companies') by list ID.
industrystring[]Filter by industry tags (TEXT[] containment, all must match).
headcount_minnumberMinimum employee count (inclusive).
headcount_maxnumberMaximum employee count (inclusive).
locationstringilike filter on headquarters city or country (e.g. 'London' or 'UK').
has_employees_in_my_networkbooleantrue = only companies with at least one contact linked via company_id in your account.
custom_attrsobjectJSONB containment filter on custom_attrs (e.g. {tier: 'A'}).
external_ids_matchobjectJSONB containment filter on external_ids (e.g. {hubspot_company_id: 'hs-123'}).
tagsstring[]Any-match filter on tags (OR).
format"json" | "csv"Response format (default json).
limitnumberResults per page (default 100, max 5000).
cursorstringPagination cursor from previous response.

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.