Adlark

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.
  • job and credits: 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

  1. Pre-flight checks: analyze every new ad before upload and flag anything below a B for a second look.
  2. 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.
  3. Client reporting: agencies attach the structured review to creative briefs.
  4. 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.