People

Find LinkedIn posts by topic or author

Required permissions: people:read.

Searches public LinkedIn posts from the last windowDays (default 30, maximum 30), or between inclusive publishedFrom and publishedTo dates within the last 365 days, for a topic by meaning and keyword, or by LinkedIn profile author. Omit topic to list an author's posts. Results are limited to posts Trayo holds, which go back 365 days; an earlier publishedFrom is refused with validation_failed. An empty result does not prove none were published. Posts arrive with a delay of about 10 days, so the most recent days may be incomplete. Returns up to limit posts per page (default 25, maximum 50), each with postId, url, the author, the author's company where known, and commentCount. Send a post's url or postId to POST /v1/posts/engagers to see who commented.

Follow nextCursor as cursor with identical search filters until hasMore is false. Dates stay fixed across pages. Author-only pages traverse current stored posts newest first; edits or inserts can change a traversal. Topic pages freeze a bounded ranked candidate pool in private temporary storage. Check coverage: exhausting that pool does not prove all stored matches were found. An expired or unavailable snapshot never silently restarts a search. Nothing is added to your workspace. Allow more than 120 seconds for the client timeout.

post/v1/posts/search

Request

  • Base URL: https://api.trayo.ai
  • URL: https://api.trayo.ai/v1/posts/search
  • Auth: HTTP bearer

Request body

topicstring

What the posts should be about. Omit when searching all posts by an author.

authorstring

Exact LinkedIn profile URL or handle of the post author. Use alone for their latest posts, or with topic. A person's name as topic does not filter authors. A valid handle format does not verify the person's identity.

windowDaysinteger

How many days back to search when publishedFrom and publishedTo are omitted, 1 to 30; default 30.

publishedFromstring

First publication date to include, YYYY-MM-DD. Send with publishedTo; overrides windowDays.

publishedTostring

Last publication date to include, YYYY-MM-DD. Send with publishedFrom; overrides windowDays.

limitinteger

Maximum posts per page. Follow nextCursor with the same search filters until hasMore is false; page size may change.

cursorstring

The previous nextCursor, verbatim with the same topic, author and date/window inputs. Effective dates stay fixed across pages. Author pages are a live traversal; topic pages use a bounded ranked snapshot.

Response

windowDaysinteger nullable required

The relative window searched, or null for explicit publication dates.

sincestring required

The earliest publication date searched, YYYY-MM-DD.

untilstring required

The last publication date searched, YYYY-MM-DD.

hasMoreboolean required

More rows remain in this traversal. For topic searches, false means the bounded ranked candidate pool ended, not that all matching stored posts were found.

nextCursorstring nullable required

Send back as cursor with the same search filters. Null at the end. Do not compute or modify it.

Changes

No recorded changes to this operation across all 1 revision of this API.