Search posts
Finds LinkedIn posts
Authorizations
Pass Authorization: Bearer <credential>, where the credential is either:
- an API key (
sk_…), generated by an organization admin in Settings, for scripts and automation; - an access token from
tth auth login(the TalkToHumans CLI), which any member of the workspace can use.
Both resolve to the same organization and user. A login token acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).
Body
At least one of keywords, author_linkedin_urls, author_company_linkedin_urls, author_industries, author_keywords or mentions. List filters match any of their values, and posts must match every filter set.
LinkedIn account ID returned by GET /v1/accounts. Required when the organization has multiple LinkedIn accounts.
^[1-9][0-9]*$Words to search for in posts. Supports LinkedIn's AND, OR and NOT.
200LinkedIn profile URLs of the posts' authors. For one contact's recent posts, prefer POST /v1/contacts/{contact_id}/find-content.
20LinkedIn company page URLs where the authors work.
20Industries of the authors' employers, as LinkedIn company pages name them, such as Software Development. An unknown one fails with the closest names.
20Words in the authors' profiles, such as founder.
200LinkedIn profile or company page URLs the posts mention.
20Only posts with an image, a video or a document.
image, video, document Most relevant first (default) or newest first.
relevance, newest Only posts from the last 24 hours, week or month.
24h, week, month Cursor returned as data.pagination.next_cursor by the previous call, with the same filters. Each page costs credits.
Response
One page of up to 50 posts. They aren't in TalkToHumans yet: add one with POST /v1/content/import, or import its engagers with POST /v1/content/engagers/import, using its linkedin_url.
Each page costs 2 credits, nothing when the organization read it within the hour.