XTwitterX ListsX CommunitiesX SpacesAPI Guide

X API New Endpoints: Lists, Communities, Spaces, Articles and Account Location

14 new SocQ X (Twitter) endpoints cover account location, verified followers, follow checks, lists, communities, media and replies, Articles, Spaces and video transcripts.

SocQUpdated November 19, 20268 min read

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 returned task_id, poll GET /v1/tasks/{task_id} until status is succeeded, then read data.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.

EndpointWhat it returnsPrice
X Account Location APICountry an account is based in, how it connects to X, join date, username changes0.7 credits ($0.0035) per account
X Verified Followers APIVerified accounts that follow a profile0.7 credits ($0.0035) per follower
Twitter Follow Checker APIFollows, followed-by and mutual flags for up to 100 pairs0.7 credits ($0.0035) per pair
X List Tweets APIA list's timeline, newest first, with reposts flagged0.7 credits ($0.0035) per post
Twitter List Members APIAccounts on a list, as full profiles0.7 credits ($0.0035) per member
Twitter List Followers APIAccounts that follow a list, as full profiles0.7 credits ($0.0035) per follower
X Communities Search APICommunities matching a keyword, with member count and URL0.7 credits ($0.0035) per community
X Community Members APIMembers of a community, as full profiles0.7 credits ($0.0035) per member
X Community Moderators APIA community's admins and moderators0.7 credits ($0.0035) per moderator
Twitter Media Scraper APIPosts from an account's Media tab, with full-quality files0.7 credits ($0.0035) per post
X User Replies APIReplies an account wrote, each with the post it answers0.7 credits ($0.0035) per reply
X Articles APIArticle title, preview line, full body, cover and engagement0.7 credits ($0.0035) per Article
X Spaces APISpace status, schedule, hosts, speakers, listeners and replays0.7 credits ($0.0035) per Space
Twitter Video Transcript APISpoken text of a post's video, with its length0.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"]}'

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