Skip to main content

​
POST /v1/score

Score a video’s viral potential based on content, niche, and format. Returns a score, a breakdown of contributing factors, and actionable suggestions.

​
Request body

FieldTypeRequiredDescription
mediaUrlstringYesPublic URL of the video or image to score
mediaTypestringYesvideo or image
contentstringNoDescription of the content or caption
nichesstring[]NoTarget niches (e.g. ["fitness", "wellness"])
typestringNoContent format — talking-head, b-roll, ugc, slideshow, podcast

​
Example request

curl -X POST https://api.vidjutsu.ai/v1/score \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: vj_live_abc123..." \
  -d '{
    "mediaUrl": "https://cdn.example.com/video.mp4",
    "mediaType": "video",
    "content": "3 morning habits that changed my physique",
    "niches": ["fitness", "wellness"],
    "type": "talking-head"
  }'

​
Example response

{
  "score": 84,
  "breakdown": {
    "hook": 92,
    "pacing": 78,
    "visualQuality": 88,
    "audioQuality": 80,
    "nicheRelevance": 82
  },
  "suggestions": [
    "Tighten the mid-section — pacing drops between 0:05 and 0:09",
    "Add a text overlay to reinforce the hook in the first second"
  ]
}

​
Response fields

FieldTypeDescription
scorenumberOverall viral potential score from 0 to 100
breakdownobjectPer-factor scores
suggestionsstring[]Actionable improvements to increase the score

​
Credits

10 credits ($1.00) per call.