Read-only

Search LinkedIn Companies

Search LinkedIn for companies by keyword, industry, location, and employee headcount range, returning up to 25 results per call with a company ID for each match. With a Sales Navigator seat, headcount, industry and the Sales Navigator-only filters route the search to Sales Navigator. You can also paste a LinkedIn or Sales Navigator company search URL to run it directly. Returns an empty array when nothing matches. Company filters the v1 Classic companies block does not declare require Sales Navigator; on Classic they return an error and zero results, never a widened search. Provider-native save_search, saved_search_id, recent_search_id and last_viewed_at are refused by name before transport.

search_companiesGET/api/v1/search/companies
crispy — bash

Example prompt: Find software companies in London with 51 to 200 employees

[
  {
    "company_id": "1441",
    "name": "Acme Analytics",
    "industry": "Software",
    "location": "London, UK",
    "headcount": "51-200"
  }
]
Permission scope
core
Access
Read-only
Daily limit
300/day
Category
Search & Discovery

What you can build

Build account lists by industry, size, and region for account-based outreach
Identify target companies in a headcount band to focus prospecting where it converts
Resolve exact company IDs to feed precise people searches and page actions
Run a saved Sales Navigator company search URL directly from your AI agent

Parameters

Inputs accepted by search_companies.

NameTypeDescription
keywordstringSearch keyword (company name, etc.)
keywordsstringSearch keywords.
industryunionIndustry: a name (resolved to an ID), an ID, comma-separated IDs, or {include, exclude} of IDs. exclude requires Sales Navigator.
locationunionHeadquarters location: a name (resolved to an ID), an ID, comma-separated IDs, or {include, exclude} of IDs. exclude requires Sales Navigator.
has_job_offersbooleanOnly companies hiring on LinkedIn. Send true; false is refused because its meaning is not documented.
headcountunionEmployee headcount: a band ("1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+") or [{min, max}]. 10001+ is {min: 10001} with no max.
network_distancearrayConnection degrees: 1, 2 or 3.
location_by_postal_codeobjectSales Navigator only. Postal-code IDs from get_search_parameters type postal_code, as {include, exclude}, with within_area as the radius in miles. within_area alone is refused.
headcount_growthobjectSales Navigator only. Company headcount growth as {min, max}. The unit is not documented.
department_headcountobjectSales Navigator only. Department headcount as {department, min, max}. department is required: IDs from get_search_parameters type department.
department_headcount_growthobjectSales Navigator only. Department headcount growth as {department, min, max}. department is required: IDs from get_search_parameters type department.
annual_revenueobjectSales Navigator only. Annual revenue as {currency, min, max}, all required. currency is an uppercase ISO 4217 code such as USD. min and max are one of 0, 0.2, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1001; max 1001 means 1000+.
followers_countarraySales Navigator only. Follower bands as [{min, max}]: min 1, 51, 101, 1001 or 5001; max 50, 100, 1000 or 5000.
fortunearraySales Navigator only. Fortune rank bands as [{min, max}]: min 0, 51, 101 or 251; max 50, 100, 250 or 500.
technologiesarraySales Navigator only. Technology IDs from get_search_parameters type technologies.
recent_activitiesarraySales Navigator only. Recent company activity: FUNDING_EVENTS and/or SENIOR_LEADERSHIP_CHANGES.
saved_accountsarraySales Navigator only. Saved-account IDs. Narrows results to LinkedIn's Saved accounts filter; it saves nothing.
account_listsobjectSales Navigator only. Account-list IDs or ALL, as {include, exclude}. IDs from get_search_parameters type account_lists.
limitnumberMax results to return (1-25, default 10)
cursorstringPagination cursor
linkedin_api"classic" | "sales_navigator"Company-search API. When omitted, Sales Navigator is used if the account has a seat and the search carries headcount, industry or a Sales Navigator-only filter; otherwise Classic.
refreshbooleanIf true, bypass cache and always run a live search. Default false.
urlstringRun a pasted LinkedIn or Sales Navigator company search/saved-search URL directly (linkedin.com/search/results/companies/... or linkedin.com/sales/search/company...). When set, all other filters are ignored.

Run LinkedIn workflows from the AI client you already use.

Create your account, connect LinkedIn, create an API key, then add Crispy to your client. Review the docs for supported workflows and safety controls.