search

Search LinkedIn Companies

Changed on

Search LinkedIn Companies

Find companies by name, industry, location, and employee count. Returns structured company data: name, profileUrl, summary, industry, location, followersCount, logoUrl. To read a single result in more depth, pass its profileUrl to publicCompany, which adds the full description, follower and employee counts, the website, and recent posts. Detailed firmographics (headquarter address, founding year, specialities, verification status, call to action) are not available from either surface, so do not promise them.

Parameters

  • keywords (optional): Search terms matched against company name, description, and specialties

Keyword syntax (Boolean operators)

Keywords support LinkedIn Boolean search syntax:

  • Exact phrase: "artificial intelligence": matches only that exact phrase
  • AND: fintech AND payments, both terms required (spaces default to AND)
  • OR: SaaS OR "cloud computing": either term
  • NOT: consulting NOT staffing, exclude unwanted terms
  • Parentheses: (AI OR ML) AND healthcare, group logic

Operators must be UPPERCASE. Precedence: Quotes > Parentheses > NOT > AND > OR.

Available filters

Pass HUMAN LABELS for location / industry: the server resolves them to LinkedIn IDs via typeahead. Numeric IDs pass through unchanged if you already have them.

FilterTypeDescription
locationstring[]HQ geo labels (e.g. ["Paris","France"]): resolved server-side
industrystring[]Industry labels (e.g. ["Software Development"]): resolved server-side
companySizestring[]Employee count codes (see below)

Company size codes

CodeEmployees
A1
B2-10
C11-50
D51-200
E201-500
F501-1,000
G1,001-5,000
H5,001-10,000
I10,001+

Response fields (per item)

FieldTypeDescription
namestringCompany display name
profileUrlstringLinkedIn company page URL
summarystring|nullCompany tagline/description
industrystring|nullPrimary industry
locationstring|nullHQ location
followersCountnumber|nullNumber of LinkedIn followers
logoUrlstring|nullCompany logo, present only when the result entity carries one

Pagination

  • Default page size: 10, max 50
  • Use start + count to paginate. Check hasMore for more pages.

Example workflows

  1. Market research: Search by industry + location → map the competitive landscape
  2. Sales targeting: Search by industry + size → build a list of target accounts
  3. Partnership discovery: Search by keywords + location → find potential partners

Credits

Cost: 1 credit for every 20 results returned, at least 1 when any come back, nothing when none.

post/search/linkedin/companies

Request

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/search/linkedin/companies
  • Auth: HTTP bearer

Request body

keywordsstring

Search keywords. Matches against company name, description, and specialties. Optional: you can search by filters alone. Supports LinkedIn Boolean syntax, use double quotes for exact phrases (e.g. "artificial intelligence"), AND to require both terms, OR for alternatives (e.g. SaaS OR "cloud computing"), NOT to exclude (e.g. consulting NOT staffing), and parentheses to group (e.g. (AI OR ML) AND healthcare). Operators must be UPPERCASE.

urlstring

A LinkedIn search URL. The category and every filter the vertical can actually apply are read from it; a facet it carries that this search cannot apply is reported back as a URL_FACET warning rather than applied, so a result set carrying those is WIDER than the URL asked for. Explicit params override anything read from the URL.

locationstring[]

Filter by company HQ location. Pass human labels (e.g. ['Paris','France']): server resolves to LinkedIn geo IDs via typeahead. Numeric IDs pass through if you already have them.

industrystring[]

Filter by company industry. Pass human labels (e.g. ['Software Development']): server resolves to LinkedIn industry IDs via typeahead. Numeric IDs pass through if you already have them.

companySizestring[]

Filter by employee count, several bands allowed and combined as OR. Pass a human employee range and it is converted for you, which is the safer form: the underlying codes are A=1, B=2-10, C=11-50, D=51-200, E=201-500, F=501-1000, G=1001-5000, H=5001-10000, I=10001+, and passing the wrong letter searches the wrong band silently rather than failing.

startinteger

Pagination offset into the accumulated result list (default 0). Results come about ten per page; use multiples of ten to skip whole pages.

countinteger

How many companies to return in total (default 10, max 50).

Response

List of LinkedIn companies matching the search criteria

successtrue required
category'companies' required
hasMoreboolean required
creditsUsedinteger required

Credits this call spent, net of anything given back. 0 when nothing was charged: a free read, a cached answer, nothing delivered.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.

Changes