Explore public social data APIs across Instagram, TikTok, YouTube, and Facebook
SocQSocQ
x/
post-quotes
profilesTwitter Profile Scraper APIfollowers-listX Followers List APIpostsTwitter Tweet Scraper APIpost-retweetersX Post Retweeters APIuser-postsTwitter User Tweets Scraper APIsearchTwitter Search APIfollowing-listX Following List APIpost-quotesX Post Quotes APIpost-repliesX Post Replies APItrendsX Trends API

Collect public quote posts for known X status URLs with commentary, author identity, media, timestamps, conversation context, and visible engagement metrics.

X Post Quotes API

Quote commentary
Source-post context
Per-post limits
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

X Post Quotes

X Post Quotes API collects public quote posts around specified X posts and returns author identity, quote commentary, media, publication time, and visible engagement data for opinion tracking, sentiment analysis, and distribution performance evaluation.

Features

  • Quote-post expansionStart from one or more public status URLs and collect the public posts that quote those sources, rather than replies or plain repost profiles.
  • Independent per-source limitsRequest 20 to 2,000 records per source post in increments of 20 while each submitted status advances through its own provider cursor.
  • Normalized commentary recordsReceive quote text, language, author identity, publication and collection times, media, entities, and visible engagement in one consistent shape.
  • Source trace and deduplicationKeep the submitted URL and parent post ID in extra, while repeated quote-post IDs are stored once across the task.

Parameters

ParametersRequiredDescription
urlsRequiredRequired public x.com or twitter.com status URLs. Supported host variants must contain a numeric post ID after /status/.
results_limitOptionalOptional maximum per submitted source post. Defaults to 100 and must be a multiple of 20 from 20 through 2,000.

How to Use

Submit known public status URLs, then poll the asynchronous task and page through its normalized quote-post records.

  1. Prepare public x.com or twitter.com URLs whose path contains /status/{numeric_id}.
  2. POST the urls array to /v1/x/post-quotes with an optional results_limit, then save task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. Read data.results.items and reuse next_cursor while has_more is true; this result cursor is separate from provider pagination.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is true

Best Use Cases

  • Study added commentary: Build a review set of what public authors added when they quoted a product launch, announcement, research link, or campaign post.
  • Identify public amplifiers: Compare quote authors and visible engagement to find accounts whose framing generated notable public response.
  • Archive quote-post snapshots: Preserve commentary, media references, timestamps, and collection-time counters for a defined list of source posts.

Pro Tips

  • Validate the hostname and numeric /status/ ID before submission; profile, search, and non-status links are rejected.
  • Budget results_limit per source post, not per task: two URLs at 100 can estimate up to 200 records.
  • Expect the same quote-post ID to appear only once in stored task results even if multiple submitted sources lead to it.
  • Treat the requested limit as a cap, not a completeness guarantee, because deleted, protected, restricted, or search-excluded posts may be absent.
  • Store nullable media, entity, conversation, and engagement fields defensively, and use collected_at when comparing changing counters.

Related APIs

Use these APIs when you need a different type of public X data.

  • Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
  • Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
  • Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
  • Twitter Search API — Find public posts by search expression with latest or top ordering and a configurable result limit.
  • X Followers List API — Collect public follower account identities and visible profile metrics for one or more X usernames.
  • X Following List API — Collect profiles followed by public X accounts, including identity, biographies, account signals, visible counters, and source usernames.
  • X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
  • X Post Retweeters API — Collect a task-level unique set of normalized public profiles for accounts that reposted known X or Twitter status URLs.
  • X Trends API — Collect current public X trend snapshots for known numeric WOEIDs with source rank, query, description, and location context.

Combine X data with public data from other supported social platforms.

X Post Quotes API — FAQ