Signalreddit · post · transcript
Transcript of a Reddit-hosted video. GET /v1/reddit/post/transcript accepts your x-api-key header. Costs 1 credit per successful fresh call; failures and opt-in cache hits (cache_max_age) are free. Native path: GET /api/v1/web/reddit/post/transcript. Same request parameters and JSON shape as the reference API, so you can switch by changing the base URL.
Request parameters
Reads the WebVTT captions Reddit publishes for v.redd.it videos (auto-generated, English; transcript_source "auto"). Without captions, runs speech-to-text on the v.redd.it DASH audio track (transcript_source "ai"). Videos with neither return 404.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Reddit post URL with a Reddit-hosted video. |
language | string | No | Reddit captions are English only; any other language skips captions and is used as the speech-to-text language hint. |
allow_long_transcription | boolean | No | Speech-to-text fallback: transcribe up to 10 min instead of the first 2 min. |
cache_max_age | string | No | Accepted for reference-API compatibility; guest reads are always live. Allowed: 1d, 3d, 7d, 14d, 30d. |
freshness | string | No | 24h (default), 1h, 7d, or live. Accepted cache hits are free; live forces refresh except simultaneous requests may share newly fetched data. |
Code examples
Set SIGNALSHELF_BASE_URL and SIGNALSHELF_API_KEY on your server.
curl "$SIGNALSHELF_BASE_URL/v1/reddit/post/transcript?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fnextfuckinglevel%2Fcomments%2F1xg8vle%2Fsecond_woman_to_ever_lift_the_dinnie_stones_side%2F" \
-H "x-api-key: $SIGNALSHELF_API_KEY"const response = await fetch(process.env.SIGNALSHELF_BASE_URL + "/v1/reddit/post/transcript?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fnextfuckinglevel%2Fcomments%2F1xg8vle%2Fsecond_woman_to_ever_lift_the_dinnie_stones_side%2F", {
headers: { 'x-api-key': process.env.SIGNALSHELF_API_KEY },
});
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
console.log(body.data, body.meta);import os, requests
response = requests.get(
os.environ['SIGNALSHELF_BASE_URL'] + "/v1/reddit/post/transcript?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fnextfuckinglevel%2Fcomments%2F1xg8vle%2Fsecond_woman_to_ever_lift_the_dinnie_stones_side%2F",
headers={'x-api-key': os.environ['SIGNALSHELF_API_KEY']},
timeout=30,
)
response.raise_for_status()
print(response.json())Response and pagination
The response contains data and meta. data includes platform, resource, sample:false, provider, and the public source payload. Lists return data.items; individual resources return data.data.
Author feeds include data.next_cursor. Return it unchanged in cursor for the next page. Feed entries can include reposts. Single-post lookups resolve the handle to a DID first. Deleted or moderated posts may be unavailable.
meta includes event_id, mode, cache, credits_charged, fetched_at, age_seconds, and duration_ms. A fresh successful result costs one credit; accepted cached results and failures cost zero.
Availability and failures
Implementation is not a continuous availability guarantee. Source rate limits, retention, deleted content, restrictions, and regional availability apply. This is an independent SignalShelf contract, not a drop-in competitor response format.
400: invalid parameters. 401: missing/revoked key. 402: insufficient credits. 404: missing public resource. 429: SignalShelf throttle. 502/503: upstream failure or rate limit, with credit restored.