An API that tells you if an ad will work — before you spend
Spendict’s ad creative analysis API takes ad copy (and optionally the visual), judges it the way a performance marketer would, and returns a deterministic run / fix_first / kill verdict your code can branch on. One POST request, a few seconds, verdicts that are the same for the same ad every time.
One request, one verdict
cat > ad.json <<'EOF'
{
"ad_copy": {
"primary_text": "Still paying an agency $3k/mo for ads a robot writes better?",
"headline": "Fire your ad agency"
},
"platform": "meta",
"product_context": "AI Meta-ads automation tool, $99/mo",
"target_audience": "DTC founders spending $2-20k/mo on Meta ads"
}
EOF
curl -sS -X POST https://www.spendict.com/api/v1/assess \
-H "Authorization: Bearer spd_live_YOUR_KEY" \
-H "Content-Type: application/json" \
--data @ad.jsonThe response scores seven dimensions and names the failure mode:
{
"overall_score": 78,
"launch_recommendation": "run",
"dimension_scores": {
"hook": 78, "angle": 80, "clarity": 82,
"audience_resonance": 80, "platform_fit": 85,
"cta": 0, "compliance_safety": 95
},
"predicted_failure_mode": "No material weakness — would run as-is.",
"prioritized_fixes": []
}Why the verdict is deterministic
Most “AI ad scoring” is a prompt away from telling you what you want to hear. Spendict’s server recomputes the overall score and the launch recommendation from fixed gates after the model has judged the ad — a dead hook or a likely policy rejection always caps the verdict at fix_first, and two failing fundamentals always mean kill. The model provides the judgment; the server derives the authoritative verdict. That’s what makes it safe to automate ad spend against.
What teams build with it
- Spend gates for AI agents — the agent generates variants, the API kills the weak ones, only
runverdicts reach the ads manager. - Batch scoring — score 50 variants in a loop and rank by
overall_scorebefore creative review, so humans only look at the top five. - Compliance pre-flight — catch likely policy rejections (the
compliance_safetydimension) before the platform does. - Agency QA — a consistent, client-defensible second opinion on every ad that ships.
Pricing and limits
Free tier: 100 calls/month, no credit card. Paid: $19/mo for 1,500 calls, $49/mo for 5,000, $199/mo for 25,000 — every tool call counts equally, quota is checked before inference, and failed calls are refunded. Errors are always structured JSON ({ error, message }), never a stack trace. Full reference in the docs, plans on the pricing page.
Frequently asked questions
Can it analyze the image or video, not just the copy?
Yes — pass a creative_url (https image or video-frame URL) and the assessment includes the visual. Copy-only assessment works without it.
Which platforms does the analysis cover?
Meta, TikTok, Google, LinkedIn, and YouTube. The platform field is required because the judgment is platform-specific — hooks that work in a TikTok feed die in a Google search ad.
How fast is it?
Median latency is a few seconds per assessment. Size your pipeline's timeout to around 30 seconds to be safe.
Is there an SDK or do I use plain HTTP?
Plain HTTP works from any language. There is also a CLI (npm i -g spendict), an MCP server for agent frameworks, and copy-paste recipes for CrewAI, LangGraph, the Claude Agent SDK, and n8n.