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/callAu prix du fournisseur
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 onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Paramètres

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.

Paramètre	Type	Obligatoire	Description	Exemple
Paramètres de requête
`url`	chaîne	Obligatoire	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`	chaîne	Facultatif	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`

Paramètres de requête
urlchaîneObligatoire
Video tweet URL — a native video tweet, not an X Article / post whose media is only article-embedded video.
Exemple : https://x.com/TheoVon/status/1916982720317821050
cache_max_agechaîneFacultatif
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...
Exemple : 7d

Exemples de code

Remplacez $TOOLSWITCH_KEY par la clé créée dans la 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());

Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.00188/call, frais de service inclus.