APIs / Social media / X (Twitter)
1 credit per call18 endpoints
X (Twitter) API
Get X (Twitter) data as structured JSON with one API key: search typeahead, notes, profile and profile articles. Free credits every month.
curl "https://api.perceptlayer.com/v1/x/profile" \
-H "X-API-Key: $API_KEY"Playground
Run this API
curl "https://api.perceptlayer.com/v1/x/profile" \
-H "X-API-Key: $API_KEY"X (Twitter) · 18 endpoints
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
| Endpoint | Required parameters | Cost |
|---|---|---|
GET/v1/x/notes | idNeeds terms | 1 credit |
GET/v1/x/profile | None+3 optionalNeeds terms | 1 credit |
GET/v1/x/profile-articles | handle+2 optionalNeeds terms | 1 credit |
GET/v1/x/profile-followers | handle+2 optionalNeeds terms | 1 credit |
GET/v1/x/profile-following | handle+2 optionalNeeds terms | 1 credit |
GET/v1/x/profile-media | handle+2 optionalNeeds terms | 1 credit |
GET/v1/x/search-typeahead | q+1 optionalNeeds terms | 1 credit |
GET/v1/x/trends | None+2 optionalNeeds terms | 1 credit |
GET/v1/x/tweet | idNeeds terms | 1 credit |
GET/v1/x/tweet-conversation | id+5 optionalNeeds terms | 1 credit |
GET/v1/x/tweet-media | idNeeds terms | 1 credit |
GET/v1/x/tweet-quotes | id+2 optionalNeeds terms | 1 credit |
GET/v1/x/tweet-reposts | id+2 optionalNeeds terms | 1 credit |
GET/v1/x/tweet-text | idNeeds terms | 1 credit |
GET/v1/x/tweet-thread | idNeeds terms | 1 credit |
GET/v1/x/tweet-transcript | idNeeds terms | 1 credit |
GET/v1/x/tweet-video | idNeeds terms | 1 credit |
GET/v1/x/user-tweets | handle+5 optionalNeeds terms | 1 credit |
Overview
About the X (Twitter) API
What you can get
The X (Twitter) API returns search typeahead, notes, profile and profile articles as clean JSON. Each successful call costs one credit, and calls that fail are free.
More social media APIs
Use cases
Monitor mentions of your brand
Use the X (Twitter) API to monitor mentions of your brandFind and vet creators
Use the X (Twitter) API to find and vet creatorsTrack trends and engagement over time
Use the X (Twitter) API to track trends and engagement over timeFAQ
Questions
How much does the X (Twitter) API cost?
Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Do I need a separate key for X (Twitter)?
No. One key works for every API in the catalogue.
Try the X (Twitter) API with 1,000 free credits
No credit card. Failed calls are never billed.