Looking for an unofficial LinkedIn API?
Here is the documented version: public data for the research.
Your own name on the send.
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
Does LinkedIn have an API you can sign up for? Not for finding people: its own API is a partner program for ads and recruiting. BeReach is a documented API for what people want from an unofficial LinkedIn API: search and enrich people from public data, then invite, message and read the inbox under your own name. 80+ operations, one key, paid per result, plus an MCP server for your AI agent.
Search people.
Every row comes back full.
{
"source": "public",
"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.
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 |
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 routes to an API.
What each one gets you.
| # | LinkedIn partner API | Sold as unofficial | BeReach | |
|---|---|---|---|---|
| 1 | Getting access | A partner review | Sign up and pay | A free trial, a key the same day |
| 2 | Finding people | Not in its scopes | Stored profile copies | Public data, read when you ask |
| 3 | Sending | No | Depends on the product | Under your own name |
| 4 | Limits | Partner quotas | Rarely published | Published: 70 messages a day |
| 5 | Docs | For partners | Varies | Every operation, with its fields |
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.
Does LinkedIn have an API for prospecting?
Not one you can sign up for. LinkedIn's own platform is a partner program for ads and recruiting, not for finding people. BeReach fills that gap with one API key. What the official API gives for free, tier by tier, is in is the LinkedIn API free?
Is the LinkedIn API free?
LinkedIn's own API costs nothing to call, but without partner approval it returns little more than your own profile. The BeReach API starts with the 14-day free trial, then charges for what each call returns. The long answer: is the LinkedIn API free?
What does an unofficial LinkedIn API usually mean?
Anything outside the partner program, often products that resell stored profile copies. BeReach is different: public data for the research, and you approve what goes out.
What can the API do?
Search and enrich people, companies and posts, find work emails, connect and message, and read the inbox and each conversation. 80+ operations behind one key, plus a 34-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 a LinkedIn account?
Not for the key, and not to search. Your key needs only the free trial, and searching people and companies needs nothing connected. Connecting LinkedIn is optional, for sending, in Claude through Chrome.
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. Up to 70 messages a day per connected account. See the usage limits page.
Can an AI agent call it directly?
Yes. The same surface ships as a 34-tool MCP server. Claude or your own agent can search, draft and queue sends, and you approve each one. See the connector page and the tool list.
Who builds with it?
CRM and sales tools that enrich records and run outreach inside their product, recruiting tools that source candidates and message them, and internal agents that search and draft for a person to approve.
How fresh is the data?
It is read when you ask. A profile changed this morning comes back changed.