--- title: "X (Twitter) API: JSON data, 18 endpoints, 1 credit per call" description: "Get X (Twitter) data as structured JSON with one API key: search typeahead, notes, profile and profile articles. Free credits every month." url: https://perceptlayer.com/apis/x --- [APIs](https://perceptlayer.com/apis) / [Social media](https://perceptlayer.com/verticals/social) / X (Twitter) 1 credit per call 18 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. [Get a free API key](https://perceptlayer.com/signup) Run it below X (Twitter) GET /v1/x/profile ``` curl "https://api.perceptlayer.com/v1/x/profile" \ -H "X-API-Key: $API_KEY" ``` cURL 1 credit per successful call Run this call below or from your dashboard to see a live response. Playground ## Run this API cURL shell ``` 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. Note Endpoints marked “Needs terms” return personal or social data. They work once you accept the [restricted-endpoint terms](https://perceptlayer.com/legal/restricted-endpoints) in your dashboard. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/x/notes`](https://perceptlayer.com/apis/x/notes) | `id` Needs terms | 1 credit | | [GET `/v1/x/profile`](https://perceptlayer.com/apis/x/profile) | none +3 optional Needs terms | 1 credit | | [GET `/v1/x/profile-articles`](https://perceptlayer.com/apis/x/profile-articles) | `handle` +2 optional Needs terms | 1 credit | | [GET `/v1/x/profile-followers`](https://perceptlayer.com/apis/x/profile-followers) | `handle` +2 optional Needs terms | 1 credit | | [GET `/v1/x/profile-following`](https://perceptlayer.com/apis/x/profile-following) | `handle` +2 optional Needs terms | 1 credit | | [GET `/v1/x/profile-media`](https://perceptlayer.com/apis/x/profile-media) | `handle` +2 optional Needs terms | 1 credit | | [GET `/v1/x/search-typeahead`](https://perceptlayer.com/apis/x/search-typeahead) | `q` +1 optional Needs terms | 1 credit | | [GET `/v1/x/trends`](https://perceptlayer.com/apis/x/trends) | none +2 optional Needs terms | 1 credit | | [GET `/v1/x/tweet`](https://perceptlayer.com/apis/x/tweet) | `id` Needs terms | 1 credit | | [GET `/v1/x/tweet-conversation`](https://perceptlayer.com/apis/x/tweet-conversation) | `id` +5 optional Needs terms | 1 credit | | [GET `/v1/x/tweet-media`](https://perceptlayer.com/apis/x/tweet-media) | `id` Needs terms | 1 credit | | [GET `/v1/x/tweet-quotes`](https://perceptlayer.com/apis/x/tweet-quotes) | `id` +2 optional Needs terms | 1 credit | | [GET `/v1/x/tweet-reposts`](https://perceptlayer.com/apis/x/tweet-reposts) | `id` +2 optional Needs terms | 1 credit | | [GET `/v1/x/tweet-text`](https://perceptlayer.com/apis/x/tweet-text) | `id` Needs terms | 1 credit | | [GET `/v1/x/tweet-thread`](https://perceptlayer.com/apis/x/tweet-thread) | `id` Needs terms | 1 credit | | [GET `/v1/x/tweet-transcript`](https://perceptlayer.com/apis/x/tweet-transcript) | `id` Needs terms | 1 credit | | [GET `/v1/x/tweet-video`](https://perceptlayer.com/apis/x/tweet-video) | `id` Needs terms | 1 credit | | [GET `/v1/x/user-tweets`](https://perceptlayer.com/apis/x/user-tweets) | `handle` +5 optional Needs 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. Social media JSON REST MCP Some endpoints need terms ### More social media APIs [Behance](https://perceptlayer.com/apis/behance) [Bilibili](https://perceptlayer.com/apis/bilibili) [Bluesky](https://perceptlayer.com/apis/bluesky) [Dailymotion](https://perceptlayer.com/apis/dailymotion) [DeviantArt](https://perceptlayer.com/apis/deviantart) [Dribbble](https://perceptlayer.com/apis/dribbble) [Facebook](https://perceptlayer.com/apis/facebook) [Facebook Ad Library](https://perceptlayer.com/apis/facebook-ad-library) [Flickr](https://perceptlayer.com/apis/flickr) [Hacker News](https://perceptlayer.com/apis/hacker-news) [Imgur](https://perceptlayer.com/apis/imgur) [Instagram](https://perceptlayer.com/apis/instagram) Use cases ### Monitor mentions of your brand `Use the X (Twitter) API to monitor mentions of your brand` ### Find and vet creators `Use the X (Twitter) API to find and vet creators` ### Track trends and engagement over time `Use the X (Twitter) API to track trends and engagement over time` FAQ ## 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. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)