profile

List the people suggested to you

Changed on

List the people suggested to your account on My Network, with name, headline, profile URL and the reason given for each, AND save them into the contact list. These are people you are NOT connected to, so it answers who is worth meeting rather than who you already know; use the connections list for people already in your network. Returns one set per call and cannot continue from where it stopped, so ask once for the number wanted. saved reports what the write actually stored.

get/me/linkedin/recommended

Request

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/me/linkedin/recommended
  • Auth: HTTP bearer

Query parameters

limitinteger

How many people to ask for, 1 to 96, 24 by default. This is a ceiling, not a promise: fewer can come back, because LinkedIn withholds the identity on some of the people it shows, and unresolved says how many. LinkedIn also answers in blocks of eight, so a smaller number still reads a whole block, and asking again re-reads from the start rather than continuing: ask once for the number actually wanted.

Response

Recommended people

successtrue required
countinteger required
savedinteger nullable

People from this page written to the contact list. Null or absent means the write has not answered: report nothing saved rather than the number of rows returned.

newToListinteger nullable

People who were not on this chat's list before this call and now are. Report this, not saved, as the number added: asking again re-reads from the start, so saved counts the same people again while only this many are new. Null or absent when there is no list or it has not answered.

servedinteger required

How many people were suggested for this call. The denominator for unresolved, and not the same as count: suggestions come in fixed blocks, so asking for fewer still reads a whole block.

unresolvedinteger required

Suggested people whose identity was not shown, so they are counted here and missing from the list, out of served. This is why a set can come back smaller than it looks.

hasMorefalse required

Always false. There is no continuation for this list, so a second call returns the same people rather than the next ones.

creditsUsedinteger required

Credits this call spent, net of anything given back. 0 when nothing was charged: a free read, a cached answer, nothing delivered.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.

Changes