Viral post
Fetch one viral post with its platform-specific extras and its media list (slides and video). Works without a bearer token; media file URLs are short-lived presigned links on the full tier and null on the free tier, where only the cover is served. Returns 404 for an unknown id.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Post id (UUID), as returned by the list viral posts endpoint.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Response
Success
Stable OctoSpark id of the post; use it with the get post endpoint.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Social platform the post was published on.
tiktok, youtube, instagram, linkedin, x, threads Public URL of the original post on its platform.
Handle of the posting account, without the leading @; null when not captured.
Opening line or on-screen hook of the post; null when not captured.
Full caption or body text; null when not captured.
What the post is made of: slideshow, video, image_post or text_post.
slideshow, video, image_post, text_post The platform's own post kind, such as photo mode versus video on TikTok.
photo, video, text Content category slug; null for posts whose source corpus had no categories.
arts-hobbies-entertainment, health-wellness, education-knowledge, relationships-lifestyle, personal-development, fashion-beauty, technology, business-finance, spirituality-beliefs, fitness, food-cooking, travel, home-design, gaming-esports, productivity-organization Which corpus the post was mirrored from.
genviral, reelfarm, content_ranker BCP 47 language tag of the text, when detected.
ISO-8601 time the post went live on its platform; null when unknown.
Engagement counts as captured at the snapshot; each count is null when the platform did not report it.
Likes, comments, shares and saves divided by plays; null when plays are unknown or zero.
Public URL of the cover image; null when no cover is stored.
Monetisation and sponsorship labels from the source corpus.
Platform-specific scalars without a dedicated field, such as dislikes, keyed by their source name.
Slides and video of the post in display order; file URLs are present only on the full tier.