Skip to main content
POST /v1/data/twitter/profiles/run Pricing: $0.0005 per profile ($0.5 per 1,000).

Ways to call it

  • Handle / URL: set inputs
  • Search: set searchTerms (optional: maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
One per line. You can input profile URLs or handles (e.g. ‘NASA’ or ‘https://x.com/NASA’).
string
Keywords or topics to find X (Twitter) accounts for (e.g. ‘climate scientist’).
integer
Number of accounts to return. Use 0 for all.

Example

Response fields

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

Example response

Abridged: long text and lists are shortened.
For their tweets use twitter/tweets; for followers use twitter/followers.