100 free credits. No credit card required
X Tweet Replies API
Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. The tweet itself is not in the list.
GET /v1/twitter/tweet/repliesLast updated November 2026Maintained by the SocialCrawl team
When to use the X Tweet Replies API
Use it with a tweet URL to read the conversation under it; the cursor walks deeper threads, and a tweet with no replies returns an empty list.
From the API reference
Returns the replies to a specific tweet, each with the reply text, author info, like count, reply count, and creation timestamp. The tweet itself is not included in the list, and a tweet with no replies returns an empty list. Page size is set by the source. Deeper threads are a cursor walk: send pagination.next_cursor back as cursor and repeat until pagination.has_more is false; each page costs 1 credit. Without sort, replies come in the platform's own ranking, not in time order. sort=latest returns replies newest first, and the cursor remembers the sort, so later pages continue in time order (X occasionally serves one reply a page late, at the top of the next page). To check for new replies, send since_id set to the newest reply id from your last check: the call returns only newer replies, newest first, and stops once it reaches older ones, so a check with nothing new returns an empty list and costs nothing. When the main source cannot fetch the first page, a second source answers with up to 40 direct replies and no cursor, so that response is the whole list; it cannot keep replies in time order, so a sort=latest or since_id call is answered by the main source only.
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchX API
What can you do with the Tweet Replies API?
The Tweet Replies endpoint gives you structured X data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/twitter/tweet/replies: Metered: holds 1 credit per page up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 12: this endpoint's measured p99 latency x 1.5.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
# Next page: send pagination.next_cursor back as cursor until pagination.has_more is false.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 12 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/twitter/tweet/replies?url=https%3A%2F%2Fx.com%2FNews24%2Fstatus%2F2093257170653483101&label=purchase_intent" && cat response.json# GET /v1/twitter/tweet/replies: Metered: holds 1 credit per page up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 12 # this endpoint's measured p99 latency x 1.5.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/twitter/tweet/replies"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"url": "https://x.com/News24/status/2093257170653483101",
"label": "purchase_intent",
}
# Walk the list: send pagination.next_cursor back as cursor until has_more is false.
MAX_PAGES = 10 # each page is one call
items = []
for _ in range(MAX_PAGES):
body = socialcrawl(params)
if body is None:
break
items.extend(body["data"]["items"])
page = body.get("pagination") or {}
if not page.get("has_more") or not page.get("next_cursor"):
break
params["cursor"] = page["next_cursor"]
print(f"{len(items)} items")// GET /v1/twitter/tweet/replies: Metered: holds 1 credit per page up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 12_000; // this endpoint's measured p99 latency x 1.5.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/twitter/tweet/replies");
url.searchParams.set("url", "https://x.com/News24/status/2093257170653483101");
url.searchParams.set("label", "purchase_intent");
// Walk the list: send pagination.next_cursor back as cursor until has_more is false.
const MAX_PAGES = 10; // each page is one call
const items: unknown[] = [];
for (let page = 0; page < MAX_PAGES; page++) {
const body = await socialcrawl(url);
if (!body) break;
items.push(...body.data.items);
const next = body.pagination?.next_cursor;
if (!body.pagination?.has_more || !next) break;
url.searchParams.set("cursor", next);
}
console.log(`${items.length} items`);Parameters worth sending
label=purchase_intentMarks each comment that shows buying intent, at no extra credits; sentiment, question and complaint are free too.
Parameters
| Parameter | Required | Description |
|---|---|---|
| url | Yes | Full URL of the tweet to fetch replies for |
| cursor | No | Cursor from the previous response's pagination.next_cursor to fetch more replies. It remembers `sort` and `since_id`, so you do not need to send them again |
| sort | No | Reply order: latest for the newest replies first, with later pages continuing in time order, or relevance for the platform's ranking. Leave it out for the default ranking, which is not in time order (relevance | latest) |
| since_id | No | The newest reply id from your last check (digits only). Returns only replies newer than it, newest first, and stops once it reaches older ones, so no next_cursor comes back after that; it also reads the next page once, so a reply X served a page late is not missed. A check with nothing new returns an empty list and costs nothing. Sets sort=latest; sort=relevance with it is a free 400 |
| label | No | Optional CSV of SocialCrawl labels to add to every comment: sentiment, spam, question, purchase_intent, complaint, toxic, low_quality, injection. Without this param every page already carries sentiment, question, purchase_intent and complaint, free; label= adds the labels you name to them (the defaults keep running). Each comment gains computed.labels with probabilities (0 to 1), so you choose the cut-off; a comment that could not be judged carries labels: null. sentiment, question, purchase_intent and complaint are free when asked for too; spam, toxic, low_quality and injection add 1 credit per started 25 newly judged comments (comments already labelled for anyone are free, and so is a cached page). injection flags text that addresses an AI system and tries to direct it (flagged, p); it never drops or rewrites a row. judgments=off (or label=none) turns the default labels off. data.labels reports what was judged and billed. |
| exclude | No | Optional CSV (spam, low_quality), only with the same preset in label. Drops comments whose probability is 0.8 or higher and lists their ids in data.labels.dropped_ids. A comment that could not be judged is never dropped. |
| judgments | No | Optional, on (the default) or off. By default every row gains free SocialCrawl judgments (computed.labels, and computed.relevance on search endpoints), reported in data.labels (mode default) and data.relevance (origin default), each with a status (complete, partial or skipped) and pending: the rows still being judged when the page was sent, which carry null now and are filled on your next call or cached read. Default judgments never add credits, never change an existing field, and never drop or reorder a row. off returns the page exactly as before, with none of those keys. label=none does the same. (on | off) |
| dry_run | No | Optional. When 1, return a cost preview for this labelled or relevance-filtered request without fetching the page or judging any row. data.estimate reports rows_expected, rows_cached, label_credits_min, label_credits_max and base_credits. 0 credits charged. (1) |
| label_evidence | No | Optional, only with label=. When 1, every labelled row also carries computed.labels_evidence.<preset> = { quote, sentence_index }: the sentence in the row that most clearly shows the label, copied verbatim. Absent or null when no single sentence shows it. (1) |
| fit | No | Optional. When goal, keep the rows and fields needed for the goal you pass in goal= (plus any that are uncertain, and the first and last), and replace the rest with a stub. data.held_back lists the held ids and a recall id that re-reads the full page from cache at no extra charge. Without this param the page is unchanged. (goal) |
| goal | No | Required by fit=goal. What you are trying to do, in your own words, up to 300 characters. |
| fit_tokens | No | Optional, only with fit=goal. Soft cap on how much of the page to keep, in tokens. Uncertain blocks and the first and last block are kept even if they exceed it. |
| since | No | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off the page, and the page that reaches one ends the walk: `next_cursor` is not returned and `pagination.stopped_at` is `since`. Sending it sets the newest-first sort shown in this endpoint's sort parameter (any other sort value is a free 400). The page still costs what a page costs, so you pay for the pages you walk and no more. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| until | No | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |
| max_pages | No | 1 to 50 (default 1, or 50 when `max_items` or `max_credits` is sent). Walk up to this many pages in one call and return the rows from all of them. Each page walked is billed exactly as one call to this endpoint (a cached page is free) and counts against your rate limit; its charge and any refund are recorded under the page's own request id, listed in `data.walk.request_ids`. The walk stops early at the last page, or when the request's time budget runs low; `data.walk.stopped` says why (`end`, `max_pages`, `max_items`, `max_credits`, `time_budget`, `page_error`) and `pagination.next_cursor` continues from where it stopped. |
| max_items | No | 1 to 5000. Get more in one call: keep walking pages until the response holds at least this many rows, then stop with `data.walk.stopped: "max_items"`. The last page is returned whole (it was billed), so `data.items` can hold up to one page more than this, and `pagination.next_cursor` resumes right after it without skipping a row. Walks up to 50 pages unless `max_pages` says fewer; each page is billed as one call (a cached page is free). Add `max_credits` to cap the spend. A long walk can stop on the time budget first (`"time_budget"`): send the returned cursor with the same params to continue. |
| max_credits | No | 1 to 100000. The most this call may spend, across every page it walks. A page starts only while the credits already spent plus that page's price (or, when higher, the most any page of this walk has cost) still fit, so the call never goes past it; the walk then stops with `data.walk.stopped: "max_credits"` and the cursor to resume. Sent alone, it walks as far as the budget goes (up to 50 pages). A value below the price of one page is a free 400 whose `error.details.page_credits` names that price. Credits a row join (`include=`) adds are known only once a page has run, so page 1 is checked against its own price. |
Example Response
What does the X Tweet Replies API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/tweet/replies",
"data": {
"items": [
{
"comment": {
"id": "2093334825075716404",
"url": "https://example.com/redacted",
"parent_id": "2093257170653483101",
"post_id": "2093257170653483101",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_e5f3d7",
"display_name": "user_d5bef4",
"avatar_url": "https://example.com/avatars/user_b94baf.png",
"verified": true
},
"engagement": {
"likes": 24,
"replies": 3
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-08-28T13:48:09.000Z",
"ext": {
"content_language": "en",
"author_followers": 1154,
"author_following": 706,
"author_posts_count": 43575,
"quote_count": 1,
"views": 3925,
"saves": 0
}
},
"computed": {
"language": "en",
"labels": {
"sentiment": {
"level": 2,
"score_0_1": 0.54,
"confidence": 0.17
},
"question": {
"p": 0.03
},
"purchase_intent": {
"p": 0.1
},
"complaint": {
"p": 0.05
}
}
}
},
{
"comment": {
"id": "2093280260154368190",
"url": "https://example.com/redacted",
"parent_id": "2093257170653483101",
"post_id": "2093257170653483101",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_0843c0",
"display_name": "user_9c7700",
"avatar_url": "https://example.com/avatars/user_b2b11a.png",
"verified": true
},
"engagement": {
"likes": 6,
"replies": 0
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-08-28T10:11:19.000Z",
"ext": {
"content_language": "tl",
"author_followers": 6584,
"author_following": 7501,
"author_posts_count": 39317,
"quote_count": 0,
"views": 1380,
"saves": 0
}
},
"computed": {
"language": null,
"labels": {
"sentiment": {
"level": 1,
"score_0_1": 0.2,
"confidence": 0.68
},
"question": {
"p": 0.09
},
"purchase_intent": {
"p": 0.04
},
"complaint": {
"p": 0.09
}
}
}
}
],
"next_cursor": "DAAKCgABHTouZHi__pULAAIAAAGoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUNVZERNNTl3OWFSRFIwTTlWK0QxakhYSFF6Vi9DN1dRTUlkRE5wYmlKWXh4UjBOQk82MGw3RTBIUTA4UUoyWGNWa2REVVYzLzFZUWt4ME0wTUIxMWlIUUhRelhsRFNYQWRJZERRWTlsbFpBeUIwTi9uRExWbUhxSFEzTFJwTFdjRHdkRFJyTHlwWndmeDBOQUxtWVZpQmhIUXpjbDdaWEFWWWRETm1GcUZkZ1pSME5GMVowbGpDK0hRemRtNkhXOEVrZERRWWZaeGJ4TkIwTTAwNVIxcUMrSFF6ZDBkb1gwSUVkRE5jM3hsZlFKaDBNelREN0Z2RTRIUXpiajVSV01IMGRETVdKeFpjQWtSME0yb21ibDBCaEhRemlzdXdYc1FNZERVOVRmNVlnR3gwTTROL0FWb0ZhSFF6b0lhaFdnRzhkREw1T1lGY1FYUjBNekZSZ21oRGtIUXpTTmNoV2dDWWREVTBtcXRkQndCME0zZDg5bDFFbEhRejJIUGtXVUJZZER3STM0cGRCTFE9PQgAAwAAAAILAAQAAAAGQm90dG9tAAA",
"total": null,
"labels": {
"presets": [
"sentiment",
"question"
],
"rows": 36,
"labelled": 36,
"cached": 36,
"skipped": 0,
"unjudged": 0,
"dropped": 0,
"dropped_ids": [],
"extra_credits": 0,
"methodology_version": "labels/1",
"mode": "default",
"status": "complete",
"pending": 0,
"pending_ids": []
},
"label_share": {
"policy_version": "share/1",
"presets": {
"question": {
"n": 36,
"counted": 1,
"abstained": 1,
"share": 0.0286,
"low": 0.0064,
"high": 0.1184,
"receipts": [
{
"id": "2093336263382155464",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false,
"at_cut": 1,
"nulls": 0,
"low_confidence": 1
},
"purchase_intent": {
"n": 36,
"counted": 1,
"abstained": 0,
"share": 0.0278,
"low": 0.0062,
"high": 0.1154,
"receipts": [
{
"id": "2093894790798590253",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false,
"at_cut": 1,
"nulls": 0,
"low_confidence": 0
},
"complaint": {
"n": 36,
"counted": 0,
"abstained": 1,
"share": 0,
"low": 0,
"high": 0.0718,
"receipts": [],
"policy_version": "share/1",
"too_few": false,
"at_cut": 1,
"nulls": 0,
"low_confidence": 1
},
"sentiment": {
"positive": {
"n": 36,
"counted": 0,
"abstained": 6,
"share": 0,
"low": 0,
"high": 0.0827,
"receipts": [],
"policy_version": "share/1",
"too_few": false,
"at_cut": 0,
"nulls": 0,
"low_confidence": 6
},
"neutral": {
"n": 36,
"counted": 2,
"abstained": 6,
"share": 0.0667,
"low": 0.0223,
"high": 0.1827,
"receipts": [
{
"id": "2093336263382155464",
"text": "Sample comment text (redacted)."
},
{
"id": "2093395650016670041",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false,
"at_cut": 2,
"nulls": 0,
"low_confidence": 6
},
"negative": {
"n": 36,
"counted": 28,
"abstained": 6,
"share": 0.9333,
"low": 0.8173,
"high": 0.9777,
"receipts": [
{
"id": "2093280260154368190",
"text": "Sample comment text (redacted)."
},
{
"id": "2093273537075147064",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false,
"at_cut": 28,
"nulls": 0,
"low_confidence": 6
}
}
}
},
"comment_language": {
"policy_version": "share/1",
"n": 36,
"abstained": 8,
"judged_by": {
"script": 0,
"choice": 28
},
"shares": {
"en": {
"n": 36,
"counted": 27,
"abstained": 8,
"share": 0.9643,
"low": 0.8548,
"high": 0.992,
"receipts": [
{
"id": "2093334825075716404",
"text": "Sample comment text (redacted)."
},
{
"id": "2093273537075147064",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false
},
"nl": {
"n": 36,
"counted": 1,
"abstained": 8,
"share": 0.0357,
"low": 0.008,
"high": 0.1452,
"receipts": [
{
"id": "2093274966372290829",
"text": "Sample comment text (redacted)."
}
],
"policy_version": "share/1",
"too_few": false
}
}
},
"comment_recency": {
"policy_version": "d09-1",
"n": 36,
"counted": 36,
"abstained": 0,
"share_last_24h": 0,
"share_later_half": null,
"too_few": false,
"stage": "unknown",
"order": "default",
"recent_share_is_floor": true,
"receipts": []
},
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiREFBS0NnQUJIVG91WkhpX19wVUxBQUlBQUFHb1JXMVFRelozUVVGQlpsRXZaMGRLVGpCMlIzQXZRVUZCUVVOVlpFUk5OVGwzT1dGU1JGSXdUVGxXSzBReGFraFlTRkY2Vmk5RE4xZFJUVWxrUkU1d1ltbEtXWGg0VWpCT1FrODJNR3czUlRCSVVUQTRVVW95V0dOV2EyUkVWVll6THpGWlVXdDRNRTB3VFVJeE1XbElVVWhSZWxoc1JGTllRV1JKWkVSUldUbHNiRnBCZVVJd1RpOXVSRXhXYlVoeFNGRXpURkp3VEZkalJIZGtSRkp5VEhsd1duZG1lREJPUVV4dFdWWnBRbWhJVVhwamJEZGFXRUZXV1dSRVRtMUdjVVprWjFwU01FNUdNVm93YkdwREswaFJlbVJ0TmtoWE9FVnJaRVJSV1daYWVHSjRUa0l3VFRBd05WSXhjVU1yU0ZGNlpEQmtiMWd3U1VWa1JFNWpNM2hzWmxGS2FEQk5lbFJFTjBaMlJUUklVWHBpYWpWU1YwMUlNR1JFVFZkS2VGcGpRV3RTTUUweWIyMWliREJDYUVoUmVtbHpkWGRZYzFGTlpFUlZPVlJtTlZsblIzZ3dUVFJPTDBGV2IwWmhTRkY2YjBsaGFGZG5SemhrUkV3MVQxbEdZMUZZVWpCTmVrWlNaMjFvUkd0SVVYcFRUbU5vVjJkRFdXUkVWVEJ0Y1hSa1FuZENNRTB6WkRnNWJERkZiRWhSZWpKSVVHdFhWVUpaWkVSM1NUTTBjR1JDVEZFOVBRZ0FBd0FBQUFJTEFBUUFBQUFHUW05MGRHOXRBQUEiLCJlIjoidHdpdHRlci90d2VldC9yZXBsaWVzIiwicCI6ImN1cnNvciJ9",
"has_more": true,
"page_size": 36
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T15:40:56.239Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the X Tweet Replies API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usWhat does the X Tweet Replies API return?
Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. The tweet itself is not in the list. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.
When should I use the X Tweet Replies endpoint?
Use it with a tweet URL to read the conversation under it; the cursor walks deeper threads, and a tweet with no replies returns an empty list.
How much does the X Tweet Replies API cost?
The price depends on the request, from 1 to 5 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.
What parameters does the X Tweet Replies API need?
The one required parameter is url (full URL of the tweet to fetch replies for). It also accepts 16 optional parameters, all listed on this page. The optional parameter to try first is label (Marks each comment that shows buying intent, at no extra credits; sentiment, question and complaint are free too).
How do I call the X Tweet Replies API?
Send a GET request to https://www.socialcrawl.dev/v1/twitter/tweet/replies?url=https%3A%2F%2Fx.com%2FNews24%2Fstatus%2F2093257170653483101 with your API key in the x-api-key header. An Authorization: Bearer header works too.
Ask AI about SocialCrawl
Ready to scrape X Tweet Replies data?
Get your API key and start pulling X data in under 60 seconds.