curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/viral-library/viral-post-1/transcript' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Viral library transcript retrieved",
"data": {
"id": "viral-post-1",
"transcript": "I used to spend every Sunday planning meals..."
}
}
Viral Library
Get Viral Library Transcript
Read the stored spoken transcript for one Viral Library post
GET
/
api
/
partner
/
v1
/
viral-library
/
{postId}
/
transcript
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/viral-library/viral-post-1/transcript' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Viral library transcript retrieved",
"data": {
"id": "viral-post-1",
"transcript": "I used to spend every Sunday planning meals..."
}
}
Read the spoken transcript for one post selected from
Search Viral Library.
This is a deliberate one-post read. Search results and ordinary post details do
not contain transcript text, so clients can inspect the corpus without loading
full scripts into their context. The response also excludes word timings,
language/model metadata, scrape data, and analysis provenance.
Path Parameters
string
required
A post
id returned by Search Viral Library.Response
string
The Viral Library post id.
string | null
The stored spoken transcript, or
null when no transcript is available.Rate limits
Transcript reads are limited to 30 per minute and 100 per day per authenticated customer, with a ceiling of 300 per minute across all callers. They spend neither the search-result budget nor the ordinary post-detail budget. A throttled request answers429 with error_code: "rate_limited" and a
retry_after_seconds value. A 503 provider_unavailable means the distributed
limiter could not count the request and failed closed; it also carries
retry_after_seconds.
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/viral-library/viral-post-1/transcript' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Viral library transcript retrieved",
"data": {
"id": "viral-post-1",
"transcript": "I used to spend every Sunday planning meals..."
}
}
Error Responses
401- authentication failed (missing, invalid, or revoked token)402 subscription_required- an active eligible subscription is required403 tier_not_allowed- the Scheduler tier cannot use the Partner API404- the post is missing or not visible to this caller422-postIdis missing or longer than 300 characters429 rate_limited- the transcript budget was reached503 provider_unavailable- the rate limiter was unreachable