Analysis API
Ad analysis API for image and video ads
Upload an ad file and its caption, get back a structured review: grade, hook, CTA, audience and funnel notes, plus a transcript and key frames for video. Useful for reviewing creative at volume.
Request
POST /api/v1/analyze takes a multipart form, not JSON, because you are sending a file.
curl -X POST https://adlark.alexshipit.com/api/v1/analyze \
-H "Authorization: Bearer adl_YOUR_KEY" \
-F "file=@ad.mp4" \
-F "caption=Tired of lukewarm coffee by 10am?" \
-F "platform=tiktok"file can be an image or a video. caption and platform are optional but improve the review: the hook in a caption and the hook in a video are judged together, and platform tells the model which conventions apply.
What comes back
analysis: grade (A-F), hook assessment, CTA assessment, audience and funnel-stage read, a scene-by-scene UGC script you could film as a remake, and five hook variations.transcript: speech from the video, transcribed with Whisper (first three minutes).frames: key frames extracted from the video, so you can show the review next to the moments it refers to.jobandcredits: the job id and the cost.
Price
Each analysis costs 56 credits by API (50 in the studio plus 10%, rounded up), for an image or a video.
Ways teams use it
- Pre-flight checks: analyze every new ad before upload and flag anything below a B for a second look.
- Swipe file review: when you save ads you admire, run them through the API and store the hook and structure notes. Our guide on analyzing competitor ads covers doing this responsibly.
- Client reporting: agencies attach the structured review to creative briefs.
- Remake pipeline: take the returned UGC script and pass it to the image API for storyboard frames.
What the grade is and is not
The grade is a model's structured opinion on craft: is there a clear hook, a clear offer, a clear next step. It does not know your audience data and is not a forecast of performance. Use it to catch obvious problems fast, then let real tests decide. The ad quality checklist lists what it looks for.
Errors
Errors return { error }: 401 bad key, 402 not enough credits, 429 rate limit, 503 temporarily unavailable. Very long videos are trimmed to the first three minutes for transcription.
Questions
+Which file types work?
Common image formats and MP4 video. For video, the first three minutes are transcribed.
+Is the analysis available over MCP?
Not as an MCP tool today. Use the REST endpoint; the MCP server covers images, copy, scripts, voiceover, credits and jobs.
+Can I analyze ads I did not make?
You can upload files you have the right to use. Saving and studying public ads for research is common practice; do not reuse other brands' assets in your own ads.
Related
Make your next ad today
Pro is $39.99 a month with 3,000 credits. Cancel anytime.