SocQ's X endpoints already returned public profiles, posts, timelines, search, replies, quotes, followers and trends; the X/Twitter collection guide covers those. On 2026-11-17, 14 more went live on the X platform page. They reach parts of X the basic endpoints did not: the "About this account" panel, lists, community members and moderators, a user's Media and Replies tabs, long-form Articles, Spaces and the speech in videos.
This guide groups them by job, shows one request for each and lists the price.
Quick answer: Send a JSON body to
POST https://api.socq.ai/v1/x/<endpoint>. Save the returnedtask_id, pollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items. All 14 endpoints cost 0.7 credits ($0.0035) per result, with one exception for long videos in Video Transcript.
The New X Endpoints at a Glance
1 SocQ credit = $0.005. There is no base fee, so an empty result costs nothing.
| Endpoint | What it returns | Price |
|---|---|---|
| X Account Location API | Country an account is based in, how it connects to X, join date, username changes | 0.7 credits ($0.0035) per account |
| X Verified Followers API | Verified accounts that follow a profile | 0.7 credits ($0.0035) per follower |
| Twitter Follow Checker API | Follows, followed-by and mutual flags for up to 100 pairs | 0.7 credits ($0.0035) per pair |
| X List Tweets API | A list's timeline, newest first, with reposts flagged | 0.7 credits ($0.0035) per post |
| Twitter List Members API | Accounts on a list, as full profiles | 0.7 credits ($0.0035) per member |
| Twitter List Followers API | Accounts that follow a list, as full profiles | 0.7 credits ($0.0035) per follower |
| X Communities Search API | Communities matching a keyword, with member count and URL | 0.7 credits ($0.0035) per community |
| X Community Members API | Members of a community, as full profiles | 0.7 credits ($0.0035) per member |
| X Community Moderators API | A community's admins and moderators | 0.7 credits ($0.0035) per moderator |
| Twitter Media Scraper API | Posts from an account's Media tab, with full-quality files | 0.7 credits ($0.0035) per post |
| X User Replies API | Replies an account wrote, each with the post it answers | 0.7 credits ($0.0035) per reply |
| X Articles API | Article title, preview line, full body, cover and engagement | 0.7 credits ($0.0035) per Article |
| X Spaces API | Space status, schedule, hosts, speakers, listeners and replays | 0.7 credits ($0.0035) per Space |
| Twitter Video Transcript API | Spoken text of a post's video, with its length | 0.7 credits ($0.0035) per video up to 2 minutes |
Authentication and the Async Task Flow
All requests authenticate with an API key. The same header is used for submit, task status and result requests:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Every collection runs as a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit call returns immediately with data.task_id and data.status. Poll the task with that ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
When status is succeeded, the response includes result_count, credits_amount and the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If results.has_more is true, pass results.next_cursor as cursor to read the next page. A failed task carries error_message.
Every endpoint below also accepts an optional callback_url. SocQ sends one POST with a task summary when the task finishes; read the records from the task endpoint. A client-side timeout does not cancel a task, so resume with the same task ID instead of submitting again. A 402 means the account is out of credits, and a 429 means the key hit a rate or credit limit.
A note on results_limit: for Verified Followers and the list and community member endpoints, it applies to each input, defaults to 100 and must be a multiple of 20 between 20 and 2000. For Communities Search it must be a multiple of 10 between 10 and 500.
Vet Accounts and Relationships
Account Location reads the "About this account" panel: country, connected_via (for example United States App Store or Web), join date, username_changes_count and affiliate_username. Use it to vet influencers and spot coordinated accounts. Some accounts, such as many government accounts, have no country; they still return a row with country: null. (docs)
curl -X POST "https://api.socq.ai/v1/x/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["elonmusk", "BBCWorld"]}'
Verified Followers returns the list X shows under the Verified Followers tab. Each row is a verified follower (actor) linked to the account you asked about (related_actor). Use it to size the influential part of an audience or build an outreach list from a competitor's followers. (docs)
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["NASA"], "results_limit": 20}'
Follow Checker compares one username with up to 100 usernames. Each pair returns is_following, is_followed_by and is_mutual. Use it to confirm campaign participants follow your brand. (docs)
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'
Read X Lists
All three take public list URLs in the /i/lists/{numeric_id} form.
List Tweets returns the list's timeline, newest first. Reposts are kept and marked with is_repost, plus reposted_post_id and reposted_author, so you can filter them out. One request monitors a whole niche. (docs)
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Members exports the accounts on a list as full profiles with bio, location, website, verification and follower, following and post counts. A hand-picked list is a ready prospecting seed. (docs)
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Followers returns the accounts that subscribe to a list, in the same profile shape. Following a list is a stated interest in its topic, which makes them a precise research segment. (docs)
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
Map X Communities
Communities Search finds communities by keyword, with name, member count, banner, is_nsfw and the community URL. (docs)
curl -X POST "https://api.socq.ai/v1/x/search-communities" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "bitcoin", "results_limit": 20}'
Pass a community URL (/i/communities/{numeric_id}) to Community Members for its members as full profiles. (docs)
curl -X POST "https://api.socq.ai/v1/x/community-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'
Community Moderators returns the full team, admins included, in one request. These are the contacts for a sponsorship or AMA. (docs)
curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'
A community's description and rules are covered in the community details guide, and its posts in the community posts guide.
Collect an Account's Media and Replies
Both take one username; results_limit defaults to 20 and accepts 1 to 1000.
Media Scraper returns the posts on an account's Media tab, newest first, with text, engagement, views and the media files. Videos point to the highest-quality MP4 available. (docs)
curl -X POST "https://api.socq.ai/v1/x/user-media" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "NASA", "results_limit": 20}'
User Replies returns the account's Replies tab, newest first. Each reply carries in_reply_to with the answered post's text, author, link and time, so every row reads as a full exchange. (docs)
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk", "results_limit": 20}'
For whole conversations, see the thread context guide.
Read Articles, Spaces and Video Speech
Articles takes the URL of the post that publishes an Article (/{username}/status/{post_id}) and returns title, the preview line as summary, the full body in text, cover image, author and likes, replies, quotes and views. A post that is not an Article returns no row; if none of the URLs is an Article, the task fails and is not charged. (docs)
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'
Spaces takes /i/spaces/{space_id} links. Each Space returns its title, status (scheduled, live or ended), scheduled_start_at, hosts, speakers, live listeners, replay views and is_replay_available. (docs)
curl -X POST "https://api.socq.ai/v1/x/space" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'
Video Transcript turns the speech in a post's video into plain text, with duration_seconds. A video up to 2 minutes costs 0.7 credits. A longer video costs 4 credits ($0.02) for every started minute of its full length, so a 3-minute video costs 12 credits ($0.06). Posts without a video return no row and are not charged. (docs)
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'
Related X Guides
To compare SocQ with other X data providers and the official API, read Twitter API Pricing and the Best X API Alternatives, 7 Best Twitter/X Scraper APIs and TwitterAPI.io Alternatives.
FAQ
What does the X Account Location API return when X lists no country?
A row with country set to null. The other fields, such as connected_via and the join date, still come back.
Why must results_limit be a multiple of 20?
That is the rule for Verified Followers, List Tweets, List Members, List Followers and Community Members: 20 to 2000 in steps of 20, applied to each input. Communities Search uses steps of 10 from 10 to 500.
Am I charged for posts that are not Articles or have no video?
No. Those posts return no row, and you pay only for rows returned. If none of the URLs sent to the Articles API is an Article, the task fails and is not charged.
How much does a long video transcript cost?
Up to 2 minutes: 0.7 credits. Longer: 4 credits per started minute of the full length, so 3 minutes is 12 credits and 5 minutes is 20 credits ($0.10).
Can I check many follow relationships at once?
Yes. Follow Checker compares one account with up to 100 others in one request, billed 0.7 credits per pair.
X API
Test the workflow with a public X URL
Submit public inputs and receive normalized records with traceable source context.
Explore X APIs