Social Parse
PricingDashboard
X (Twitter)

Tweet transcript

A video post's captions, the ones X makes from its speech, as one text and as timed segments. A post without a video, or a video without captions, answers NOT_FOUND.

GET/v1/twitter/tweets/transcript1 credit

Headers

Get your API key
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
tweet_idstringoptionalquery

A post's id: the digits after /status/ in its link. Give tweet_id or url.

example: 1916982720317821050

urlstringoptionalquery

A post's link: x.com/<handle>/status/<id> or twitter.com/..., with anything after it. Give tweet_id or url.

max 300 chars

Response fields

19
dataobject

The result: one object, or a list for the endpoints that return several.

data.tweet_idstring

The post's id.

data.languagestring

The captions' language: en, es and so on.

data.textstring

The whole transcript: every segment's text, joined.

data.segmentsarray

The captions in order, each with its start and end.

data.segments[].startnumber

When the caption starts, in seconds from the video's start.

data.segments[].endnumber

When it ends, in seconds.

data.segments[].textstring

What is said.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/twitter/tweets/transcript?tweet_id=1916982720317821050' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "tweet_id": "string",    "language": "string",    "text": "string",    "segments": [      {        "start": 0,        "end": 0,        "text": "string"      }    ]  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

Tweet replies

A post's top replies: the threads its page shows logged out (3 on most posts), each a reply and any replies under it (reply_to_id says which post each answers). A reply x.com won't show logged out is left out. There is no next page.

Community

A community: its name, description, members, topic, rules and who made it.