Videos

Operations

• Search videos

  POST/v1/videos/search

  3 credits per platform searched, per page (9 credits for the default three). intelligence: true adds 20 credits for each of the top 20 results enriched, whether analysed now or already.

• Look up a video by URL

  POST/v1/videos/lookup

  3 credits, the same when a Snapshot under 24 h old can answer.

• Get a video

  GET/v1/videos/{platform}/{id}

  3 credits. With include=intelligence: 23 credits instead of the lookup price. With include=transcript only: a flat 10 credits. With include=download: 3 credits alone, else 3 credits on top of the analysis or transcript price. A stored answer (or an existing copy) costs the same as a fresh one.

• Analyse a video

  POST/v1/videos/{platform}/{id}/intelligence

  23 credits, whether computed now or already stored, and with refresh: true.

• Score a video

  POST/v1/videos/{platform}/{id}/score

  9 credits, always fresh — asking for a score is asking for the fetch.

• Get video comments

  GET/v1/videos/{platform}/{id}/comments

  3 credits per page, plus 10 credits with analyze=true, whether the analysis is computed now or already stored.