Skip to main content
POST
Submit X User Posts task

X User Posts

Collect recent public posts for one or more usernames. Replies are excluded.
results_limit specifies the maximum number of posts returned for each username. The total number of results can be up to the number of usernames multiplied by results_limit. Billing is based on the total number of results returned. Results use the normalized structure documented in X Posts, with resource set to user-posts. The submitted username is returned under extra.input_username.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
usernames
string[]
required

Public X usernames. A leading @ is optional.

Minimum array length: 1
Minimum string length: 1
results_limit
integer
default:20

Maximum posts to collect per username.

Required range: 20 <= x <= 2000Must be a multiple of 20
callback_url
string<uri>

Optional callback URL.

Response

Task submitted

code
integer
Example:

200

data
object