X (Twitter) API
Get public X (Twitter) profiles, posts, timelines, followers, search results, replies and threads, articles, lists, communities, Spaces, and trends.
28 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Community
4 endpoints- Get community (v1)GETGet a community's name, description, member and moderator counts, join policy, rules, creator, and admin. An unknown ID returns data: null.
/v1/x/community1 cr - List community members (v1)GETList the members of a community. Paginate with cursor and has_more. An unknown community ID returns data: null.
/v1/x/community/members6 cr - List community moderators (v1)GETList the moderators of a community. Paginate with cursor and has_more. An unknown community ID returns data: null.
/v1/x/community/moderators6 cr - List community posts (v1)GETList posts in a community. A page can be empty while has_more is true, so keep paging with cursor until it is false. An unknown community ID returns data: null.
/v1/x/community/posts5 cr
List
3 endpoints- List list followers (v1)GETList the accounts that follow an X list. Paginate with cursor and has_more. An unknown list ID returns data: null.
/v1/x/list/followers6 cr - List list members (v1)GETList the accounts that belong to an X list. Paginate with cursor and has_more. An unknown list ID returns data: null.
/v1/x/list/members6 cr - List posts in a list (v1)GETList recent posts from the accounts in an X list. Paginate with cursor and has_more. An unknown list ID returns data: null.
/v1/x/list/posts5 cr
Post
7 endpoints- Get article (v1)GETGet the long-form article attached to a post: title, author, counts, and body blocks including images. A post without an article returns data: null.
/v1/x/article2 cr - Get post details (v1)GETGet a post by ID or status URL, with text, counts, author, media, and any quoted or reposted post. An unknown ID returns data: null.
/v1/x/post1 cr - Get post thread (v1)GETGet the conversation around a post: the posts it replies to and the replies that follow. Paginate with cursor and has_more. An unknown post ID returns data: null.
/v1/x/post/thread9 cr - List post quotes (v1)GETList posts that quote a post. Paginate with cursor and has_more. A post with no quotes returns an empty posts array. An unknown post ID returns data: null.
/v1/x/post/quotes5 cr - List post replies (v1)GETList replies to a post, ordered by relevance, recency, or likes. Paginate with cursor and has_more. A post with no replies returns an empty posts array. An unknown post ID returns data: null.
/v1/x/post/replies5 cr - List post reposters (v1)GETList accounts that reposted a post. Paginate with cursor and has_more. A post with no reposts returns an empty profiles array. An unknown post ID returns data: null.
/v1/x/post/retweeters5 cr Get post (v1)DeprecatedGETDeprecated: use /v1/x/post instead. Get an X post by ID, including its text, engagement counts, author, and available quoted or reposted post. An unknown ID returns data: null./v1/x/tweet1 cr
Search
2 endpoints- Search posts (v1)GETSearch posts with X search operators, newest or most engaged first. Paginate with cursor and has_more. A malformed query returns 400; no matches return an empty posts array.
/v1/x/search5 cr - Search profiles (v1)GETFind accounts by name, handle, or keyword. Paginate with cursor and has_more. No matches return an empty profiles array.
/v1/x/search/profiles6 cr
Space
1 endpointTrends
1 endpointUser
10 endpoints- Check follow relationship (v1)GETCheck whether one account follows another, in both directions. An unknown handle returns data: null.
/v1/x/profile/relationship2 cr - Get profile (v1)GETGet an account's public profile: name, bio, location, follower and post counts, verification, and pinned post IDs. An unknown handle returns data: null.
/v1/x/profile1 cr - Get profile About details (v1)GETGet an account's About panel: creation date, verification history, country, handle-change count, and affiliation. An unknown handle returns data: null.
/v1/x/profile/about1 cr - List followed accounts (v1)GETList accounts a profile follows, up to 200 per page. Paginate with cursor and has_more. An unknown handle returns data: null or an empty page.
/v1/x/profile/followings3 cr - List followers (v1)GETList accounts that follow a profile, up to 200 per page. Paginate with cursor and has_more. An unknown handle returns data: null or an empty page.
/v1/x/profile/followers3 cr - List profile mentions (v1)GETList posts that mention an account, newest first. Paginate with cursor and has_more. An unknown handle returns data: null or an empty page.
/v1/x/profile/mentions5 cr - List profile posts (v1)GETList an account's posts newest first, plus its pinned post. Set include_replies to add the account's replies. Paginate with cursor and has_more. An unknown handle returns data: null or an empty page.
/v1/x/profile/posts5 cr - List verified followers (v1)GETList verified accounts that follow a profile. Needs the numeric user_id, which /v1/x/profile returns as id. Paginate with cursor and has_more. An unknown user_id returns data: null.
/v1/x/profile/verified-followers1 cr Get account (v1)DeprecatedGETDeprecated: use /v1/x/profile instead. Get an account's public profile, verification status, and activity counts. An unknown handle returns data: null./v1/x/user1 crList account posts (v1)DeprecatedGETDeprecated: use /v1/x/profile/posts instead. List an account's posts with text, engagement counts, entities, and author details. An unknown handle returns data: null./v1/x/tweets1 cr
What you can build
- Monitor keywords, hashtags and accounts with post search.
- Map an audience through followers, followings and replies.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/x/search?query=<query>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.