public

Find companies from public data

Changed on Oct 22, 2026

Find companies from public data. Each row is the company's own identity: name, homepage, what it says it does, headcount, city, country and founding year. No people and no company page link come back. When a company size, a funding window or companies to leave out are set, the answer says how many companies it left out: say so. The companies come from our index, so a recent change to a company can be missing. Cost: each search costs by the results it brings back: 4 credits for up to 10, 11 for 25, 49 for 100; a company size check adds 1 credit for every 2 companies. creditsUsed says what the call spent.

post/public/companies

Request

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

Request body

limitinteger

Target number of companies.

moreboolean

Continue an earlier call on this same ask instead of returning the same companies.

sentencestring

The person's own words for the companies they want. An industry, keywords or a company is still needed beside it: the companies found are checked against those.

Response

Matched companies

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.

providerstring required

Which search answered.

querystring required

The exact query sent, so a thin result set can be read rather than guessed at.

moreAvailableboolean required

Whether asking again with more can still reach rows you have not seen. False means this ask is walked out; say so and do not call more again.

duplicatesinteger

Rows a continuation re-reached and dropped as already delivered. Normal bookkeeping, never a failure.

namedNotestring

Says the first row is the company named in the ask itself.

sizeNotestring

The size filter's counts in one sentence, to relay as written.

fundingNotestring

The funding window's counts in one sentence, to relay as written.

exclusionNotestring

The exclusions' counts in one sentence, to relay as written.

notestring

Present only when the page is empty because the companies found did not read as the kind asked for. Relay it; asking again in other words is the next step.

Changes

Oct 22, 2026549f4adbbfcf Revision 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
Oct 21, 2026d04cdb8563c3 Revision changes
- info
  added the new optional request property

Operation history (11 revisions)