public

Find the people at a company from public profiles

Changed on

The people who work at one named company now, from public profiles. Give the company by name or page address, and a role in keywords to narrow to whoever holds it. The people come from our index, about 3 weeks old at the median, so a recent job move can be missing. Cost: each search buys the smallest page that covers the count, 4 credits for up to 10, 11 for 25, 49 for 100, and another is bought only when the first did not find enough; more pays only for the searches not bought before; nothing when nobody comes back. creditsUsed says what the call spent.

post/public/employees

Request

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

Request body

companystring required

The company, by name or by its page address.

keywordsstring

A role to narrow to, written the way people write it on their own profile.

countinteger

How many people to return.

moreboolean

Continue past the people already returned for this company and role.

sentencestring

The person's own words for who they want at this company. Everyone found is still checked to work at the company.

Response

People at the company

source'public' 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.

companystring required

The company as it was searched.

employerNotestring

Those counts in one sentence, to relay as written.

savedinteger nullable required

How many of these people were written as contacts by this call. Null when that write failed.

pooledinteger

How many were linked into this conversation's list.

duplicatesinteger

People this continuation found again that an earlier call already returned. Normal bookkeeping, never a failure.

matchingKeywordsinteger

When a role was given: how many people at the company hold it.

keywordNotestring

Present when nobody found holds the role: the people returned are the company's, not holders of that role. Relay it.

notFoundstring

Present when nobody states in public that they work at this company. Nobody is returned rather than people elsewhere. Relay it.

publicNotestring required

What these people are: the ones who say in public that they work there, a slice of the team rather than its full payroll.

moreAvailableboolean required

Whether asking again with more can still return people not yet seen.

Changes

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

    • info

      added the required property to the response with the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status