Skip to main content
POST /v1/data/threads/posts/run Pricing: $0.0025 per post ($2.50 per 1,000).

Ways to call it

  • Handles: set handles (optional: postedAfter, postedBefore, maxResults)
  • Search Keywords: set queries (optional: postedAfter, postedBefore, maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
One or more handles. One request reads them all.
string[]
One or more search keywords. One request reads them all.
date
Posted After as a date (YYYY-MM-DD).
date
Posted Before as a date (YYYY-MM-DD).
integer
default:"100"
How many posts to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one post, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For profile stats use threads/profiles.