search

Search people at a company

Changed on

The people who currently work at one named organisation. This is the current-employee list, so it is the way to answer a request about one organisation's people, including whoever holds a role there: give the organisation and put the role in keywords. Cost: 1 credit for every 20 results returned, at least 1 when any come back, nothing when none.

post/search/linkedin/employees

Request

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

Request body

companystring required

The company, as its LinkedIn page URL, its vanity slug, or its display name. Each of the three is matched to one company page, and an input matching none is refused rather than searched without the filter.

keywordsstring

ONE thing to look for among that organisation's people: a single role, a single name, or a single skill. Every word here has to appear on the same person, so naming several different roles at once describes nobody and returns a muddle of near misses. Several roles means one call each, and the answers are then separate and each one is right.

startinteger

Pagination offset into the accumulated employee list (default 0).

countinteger

How many people to return in total (default 10, max 50). Never one, even when one person is wanted: the results come back in the organisation's own order rather than ranked against keywords, so the first row is often somebody whose title merely resembles the one asked for. Ask for several and say which of them is the person; asking for one turns that into a coin toss, and it lands wrong often enough to matter.

Response

People at the company

successtrue required
companystring required

Resolved company key used for the search (slug or name as passed after parse).

hasMoreboolean required
savedinteger nullable

People from this page written to the contact list. Null or absent means the write has not answered: report nothing saved rather than the number of rows returned.

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