Platforms

X API

Search public posts and conversations, resolve author profiles with follower metrics, and monitor what a niche is talking about right now.

Endpoints

POST

/search

Post and conversation search with author context.

→POST

/profile

Resolve any public profile with full metrics.

→POST

/emails

Email enrichment is not available for X.

n/a POST

/jobs

Durable background jobs for bulk work.

→

Example

curl -X POST 'https://stormy.ai/api/v1/search' \
  -H 'Authorization: Bearer YOUR_STORMY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform":"x","query":"founders talking about lead generation","limit":25,"fresh":true}'

Profile fields

idhandlenamedescriptionimageverifiedlocationwebsitefollowersfollowingposts_countjoined_at

Post fields

textcreated timelanguagelikesrepliesrepostsquotesviewsbookmarksconversation and author

Fields are returned when public and supplied by the selected source — treat platform-specific fields as nullable.

Lookup formats

@handle — profile URLs, @handles, usernames, and platform IDs all resolve through POST /api/v1/profile.