API documentation

Twitter/X endpoints with predictable request contracts.

This documentation lists the high-signal endpoints most teams need first. Production field lists, quotas, and access levels are finalized through sales.

Public data only Every endpoint below returns publicly available information. Private accounts, protected posts, and direct messages are out of scope. See scope and compliance for the full boundary.

GET

Search posts

Search recent public posts by keyword, phrase, author filter, or boolean expression.

/api/v1/search

Parameters

Name	Type	Required	Description

Request example

curl "https://api.twitterdata.io/api/v1/search?query=from:openai api&type=Top&count=20" \
  -H "Authorization: Bearer $TWITTERDATA_KEY"

Notes

Authentication

Bearer keys with production and test separation.

Each team receives a production key after onboarding. Test keys can be issued for integration work before live traffic starts.

Authorization: Bearer pw_demo_xxxxxxxxxxxxx
Content-Type: application/json
X-Request-Id: your-trace-id