AI API: Tear down one video ad

Turns a transcript, a cut list and the published ad copy into a structured teardown: the first-3-second hook, the script's stages, the offer, the call to action and the claims made. Takes no media and returns only what the supplied evidence supports.

25 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

transcript*

scenes?array<>

Cut list from /v1/media/scenes.

Itemsitems <= 200

ad?

Whatever the ad library published. Everything is optional — an ad with no copy is analysed from its transcript alone.

Default{}

curl -X POST "https://example.com/v1/ai/ad-teardown" \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "transcript": {      "text": "string"    }  }'

{  "data": {    "hook": {      "text": "string",      "type": "question",      "source": "spoken"    },    "script_structure": [      {        "stage": "hook",        "start": 0,        "end": 0,        "summary": "string"      }    ],    "offer": {      "present": true,      "description": "string",      "discount": "string",      "urgency": "string"    },    "cta": {      "present": true,      "text": "string",      "action": "shop"    },    "claims": [      {        "text": "string",        "source": "spoken",        "type": "performance"      }    ],    "language": "string",    "confidence": "high",    "input": {      "transcript_chars": 0,      "segments_used": 0,      "segments_dropped": 0,      "scenes": 0,      "hook_window_seconds": 0    }  }}