Prospecting data API
People, companies, signals, work emails and phone numbers.
Fresh data, priced per result.
curl -X POST https://api.bereach.ai/public/search \
-H "Authorization: Bearer $BEREACH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filters":{"title":"head of sales","location":"Berlin","industry":"software"},"limit":25}'In short
BeReach is a documented prospecting data API: find people, companies, posts and signals, then get the work email or the phone number of the ones you keep. Every person comes with their current role, company and place, and what they did lately. 80+ operations, one key, paid per result, plus an MCP server for your AI agent.
Search people.
Every row comes back full.
{
"urlsFound": 25,
"hydrated": 25,
"moreAvailable": true,
"spent": { "amount": 0.125, "currency": "EUR" },
"contacts": [
{
"name": "Léa Fontaine",
"headline": "Head of Sales DACH at Kuvio",
"company": "Kuvio",
"location": "Berlin, Germany",
"profileUrl": "https://www.linkedin.com/in/<public-identifier>",
"summary": "I help software teams in DACH sell to the mid-market.",
"positions": [
{ "title": "Head of Sales DACH", "companyName": "Kuvio",
"startDate": { "year": 2024 }, "isCurrent": true }
],
"educations": [
{ "schoolName": "HWR Berlin", "endDate": { "year": 2016 } }
],
"recentPosts": [
{ "text": "We are hiring two SDRs in Berlin",
"likes": 48, "datePublished": "2026-11-03" }
],
"employer": { "name": "Kuvio", "employees": 140,
"industry": "Software", "founded": 2017 }
}
]
}The example person is invented. Up to three recent posts, with date and likes. The work email: POST /emails/find. The phone number: POST /phones/find.
Every endpoint.
What you send, what comes back.
| # | Endpoint | You send | You get back |
|---|---|---|---|
| 1 | POST /public/search | A role, a place, an industry, or a sentence | People, each row full |
| 2 | POST /public/profile | A profile address, or up to 25 | The profile, career and education |
| 3 | POST /public/employees | A company and a role | The people who work there |
| 4 | POST /public/companies | An industry, a size, a place, or a sentence | Companies |
| 5 | POST /public/company | A company page or a name | Industry, size, headquarters, founded year |
| 6 | POST /public/post-search | A topic, or who posted | Posts, with author and date |
| 7 | POST /public/signals | An event: a raise, a hire, a new role | The people to contact where it happened |
| 8 | POST /public/plan-searches | A sentence or your website | A plan of searches; /public/run-searches runs it |
| 9 | POST /emails/find | The people you keep | Their work email, checked before delivery |
| 10 | POST /phones/find | The people you keep | Their phone number |
What a call costs.
Per result, never per try.
A search that finds nothing costs one of what it looks for. Prices before VAT. Planning a search is free.
Three ways in.
The same data behind each.
| # | The API | The MCP server | The connector for Claude | |
|---|---|---|---|---|
| 1 | Made for | Your own code | Your own AI agent | Claude, ready to use |
| 2 | What it is | 80+ operations over HTTPS and JSON | 33 tools your agent calls | The same tools, added in one line |
| 3 | What comes back | People, companies, signals, emails, phones | The same | The same |
| 4 | Price | Per result | Per result | Per result |
Every error
comes with a next step.
| # | Status | Code | Next step |
|---|---|---|---|
| 1 | 400 | bad_request | The message names the field. Nothing ran. |
| 2 | 401 | unauthorized | Send your key as a bearer token. |
| 3 | 403 | subscription_required | Start a plan or the free trial, or add money. A cancelled trial: Keep my trial in Settings, before it ends. |
| 4 | 429 | rate_limit_exceeded | Wait retryAfter seconds, then repeat. On /public/* it is at the top level, elsewhere under error. |
| 5 | 429 | quotaKind: credits | Nothing left to spend. Add money at upgradeUrl and the call goes through, or wait retryAfter for the monthly refill. When details names the five-hour usage limit, wait retryAfter, or add money at upgradeUrl to go on at once. |
| 6 | 502 | bad_gateway | Retry once. Nothing partial is saved. |
An API or an MCP? Both, the same tools.
Give your agent one line and BeReach works inside it: Claude, ChatGPT or any agent, next to the tools you already use.
set up bereach - https://bereach.ai/llms.txt 
The API, answered.
What is a prospecting data API?
One API that returns the people, companies and signals you prospect from, and the work email or phone number of the ones you keep. BeReach gives you all of it behind one key.
Is the API free to try?
Yes. It starts with the 14-day free trial, then charges for what each call returns.
What data comes back?
People, companies, posts and signals, and on demand work emails and phone numbers. Every person comes with their current role, company and place, and what they did lately.
What can the API do?
Search and enrich people, companies and posts, find signals such as a raise, a hire or a new role, and find work emails and phone numbers. 80+ operations behind one key, plus a 33-tool MCP server for your agent.
What does a call cost?
The API is included in every BeReach plan: pay as you go from €20, or Pro with 14 days free. Each call is charged for what it returns, from €0.005 a person found on Pro, and a call that finds nobody costs one person. See the pricing page.
How do I authenticate?
With an API key you create in Settings at chat.bereach.ai once your free trial is on, sent as a bearer token on every call. Details in the key documentation.
Do I need to connect anything?
No. Your key needs only the free trial, and every search works with nothing connected.
What does a people search return?
A JSON object with the count found and a
contactsarray. Each row has the name, headline, company, location and profile URL, and when they are there the About text, the career, recent posts and the employer's facts.Do you keep my data?
The people a search finds are saved in your own workspace. Send
save: "skip"to get the rows without saving them. See the privacy policy and the subprocessors list.Are there rate limits?
Yes. A call over the limit answers 429 with
retryAfter: wait that many seconds and repeat. Each status and its next step are in the table above.Can an AI agent call it directly?
Yes. The same surface ships as a 33-tool MCP server. Claude or your own agent searches, gets the facts on each person and drafts, and you approve what goes out. See the connector page and the tool list.
Who builds with it?
CRM and sales tools that enrich records inside their product, recruiting tools that source candidates, and internal agents that search and draft for a person to approve.
How fresh is the data?
Fresh at the moment you ask. A role changed this morning comes back changed.