Analyze a Post Visually

Queues a structured visual analysis for a post: for a video, a scene-by-scene breakdown (per-scene timing, scene type, on-screen text, visual elements and a recreation note) plus an overall-style summary (color palette, text style, editing pace); for an image slideshow, per-slide text and visual descriptions. Accepts a public post URL or an internal post id. Asynchronous: returns a job reference to poll with get_job_status; once complete the analysis is attached to get_post responses (includeVisualAnalysis). Credits are charged on queueing and automatically refunded if the job fails. This is the visual twin of request_transcript.

Cost: 10 credits per call. Asynchronous: poll GET /api/v1/jobs/{jobRef}.

post/api/v1/visual-analysis

Request

  • Base URL: https://viraloutliers.com
  • URL: https://viraloutliers.com/api/v1/visual-analysis
  • Auth: HTTP bearer

Request body

urlstring

Public post URL (e.g. a TikTok/Reel/Short link). The easy path when you have a link.

postIdstring

Internal post id (from search results). Provide this or url.

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.