public

Read a public profile

Changed on Oct 22, 2026

Read a professional profile, or up to 25 in one call, and save each as an enriched contact. One profile is read on preview and several in full, unless detail says otherwise. Preview gives the name, current employer, place, photo, follower count, the opening of the About and the latest posts, in about 3 seconds. Full gives the real headline, the current title with its start date, the dated career, schools, place and country, the About, languages and the connection and follower counts, usually live (readAt says when an older copy was used), in about 2 seconds a person. Your own profile is read in full and never saved. This is the default way to look up or enrich a person. Cost: 1 credit a person on preview and at most 1 credit a person on full; nothing for a person a search already returned or one not read. creditsUsed says what the call spent.

post/public/profile

Request

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

Request body

profileUrlstring

Full public profile URL. Provide this or slug.

slugstring

Profile vanity slug. Provide this or profileUrl.

profileUrlsstring[]

Several profile URLs or slugs, read in one call. Each comes back as its own row, in the order asked, with whether it was found.

meboolean

Your own profile, read in full and never saved. No profileUrl or slug needed.

countrystring

ISO alpha-2 country of the person, when known.

saveboolean

When true, the fetched profile is saved to your contacts.

detail'preview' | 'full'

How much of each person to read. "preview" (default for one profile): a quick look; it can miss the current title and older posts. "full" (default for several): every detail we have. Choose full for one person when the job title, how long they have held it, or the whole dated career matters. A person a search already returned is not read again.

Response

Public profile data

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 subschema #1 subschema #2 to the response body anyOf list for the response status
- info
  removed subschema #1 subschema #2 from the response body anyOf list for the response status
Oct 22, 2026bdaed6984b20 Revision changes
- info
  added the new optional request property
- info
  added subschema #1 subschema #2 to the response body anyOf list for the response status
- info
  removed subschema #1 subschema #2 from the response body anyOf list for the response status

Operation history (7 revisions)