Skip to main content
POST
Search posts

Authorizations

Authorization
string
header
required

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

application/json

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.

account_id
string

LinkedIn account ID returned by GET /v1/accounts. Required when the organization has multiple LinkedIn accounts.

Pattern: ^[1-9][0-9]*$
keywords
string

Words to search for in posts. Supports LinkedIn's AND, OR and NOT.

Maximum string length: 200
author_linkedin_urls
string[]

LinkedIn profile URLs of the posts' authors. For one contact's recent posts, prefer POST /v1/contacts/{contact_id}/find-content.

Maximum array length: 20
author_company_linkedin_urls
string[]

LinkedIn company page URLs where the authors work.

Maximum array length: 20
author_industries
string[]

Industries of the authors' employers, as LinkedIn company pages name them, such as Software Development. An unknown one fails with the closest names.

Maximum array length: 20
author_keywords
string

Words in the authors' profiles, such as founder.

Maximum string length: 200
mentions
string[]

LinkedIn profile or company page URLs the posts mention.

Maximum array length: 20
media_type
enum<string>

Only posts with an image, a video or a document.

Available options:
image,
video,
document
sort
enum<string>

Most relevant first (default) or newest first.

Available options:
relevance,
newest
posted_within
enum<string>

Only posts from the last 24 hours, week or month.

Available options:
24h,
week,
month
cursor
string

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.

data
object
required