X (Twitter) video tweet transcript by URL

scrapecreators.x.v1-twitter-tweet-transcript

Extracts the transcript from a Twitter video tweet using AI-powered transcription.

Price: $0.00188/callPelo preço do provedor
Success rate: 100%Last 30 days · 473 calls
Latency p50: 5.6 sp95 14 s
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/scrapecreators.x.v1-twitter-tweet-transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050

Preview

Try onlineEm breveProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parâmetros

This endpoint targets a native video tweet URL. X Articles / posts whose media is only article-embedded video may return HTTP success with transcript: null while still charging the normal per-call credit — treat null as unsupported / no transcript available for that URL shape, not as a successful empty caption. For those posts, call scrapecreators.x.v1-twitter-tweet (tweet detail) first; if it exposes embedded video URLs, decide whether another transcript path applies. Observed; not a documented provider guarantee.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`url`	string	Obrigatório	Video tweet URL — a native video tweet, not an X Article / post whose media is only article-embedded video.	`https://x.com/TheoVon/status/1916982720317821050`
`cache_max_age`	string	Opcional	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Cac...	`7d`

Parâmetros de consulta
urlstringObrigatório
Video tweet URL — a native video tweet, not an X Article / post whose media is only article-embedded video.
Exemplo: https://x.com/TheoVon/status/1916982720317821050
cache_max_agestringOpcional
If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Cac...
Exemplo: 7d

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/scrapecreators.x.v1-twitter-tweet-transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/scrapecreators.x.v1-twitter-tweet-transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/scrapecreators.x.v1-twitter-tweet-transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.00188/call, incluindo a taxa de serviço.