engagement

Collect posts of a profile

Changed on

Recent posts of a person or a company page, newest first, each with its text, date, reaction, comment and share counts and its author. Set more true only if the user asked for another page or tapped Load more. For their posts on one subject, give topic. Full reads the recent posts a page at a time, newest first, up to date, in about 2 seconds a page; preview reads the latest few, with likes only, in about 3 seconds. Cost: on full, 1 credit a page of posts; on preview, 1 credit; a topic is priced as a post search; nothing when nothing was read. creditsUsed says what the call spent.

post/collect/linkedin/posts

Request

  • Base URL: https://api.bereach.ai
  • URL: https://api.bereach.ai/collect/linkedin/posts
  • Auth: HTTP bearer

Request body

profileUrlstring required

LinkedIn profile or company page URL, vanity name, or URN.

moreboolean

Next page of the same profile. Set only when the user asked for more posts or tapped Load more.

detail'preview' | 'full'

"preview": a quick look; it can miss older posts and every count but likes. "full" (default): every detail we have. Keep full for every recent post with every count, page after page.

topicstring

Only their posts about this subject, found by a post search by them on it, priced as that search: the answer is its rows. Leave it out to read their recent posts in order.

Response

Collect-run id for profile posts

successtrue required
runIdstring

Collect-run id. Posts arrive on the run record; this response holds the pages collected so far, and with more only the new page. Absent when the public page's latest few answered.

statusstring required
countinteger
unreadableinteger

Pages of this profile's posts that could not be read. Above 0 means an empty or short list is unread rather than a profile that does not post, and must not be reported as one.

postsUnavailableinteger

The same count, named for the surface it belongs to.

moreAvailableboolean

True when another page of posts exists. Do not fetch it unless the user asked or tapped Load more.

hasMoreboolean
remainderstring

When more pages exist: this page only, do not say fully collected, all pages, or no more remain.

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