Copy API
Ad copy API for hooks, headlines and CTAs
Give the product, audience and offer; get back a full copy set in structured JSON, ready to drop into your own tools, sheets or ad uploads. UGC scripts have their own endpoint next to it.
Request
curl -X POST https://adlark.alexshipit.com/api/v1/copy \
-H "Authorization: Bearer adl_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"product": "Insulated steel water bottle, 750 ml",
"details": "Keeps drinks cold 24h, fits car cup holders",
"audience": "Commuters and gym-goers",
"offer": "Free engraving this week",
"platform": "instagram",
"tone": "friendly",
"language": "en"
}'Only product is required. The more specific the details and audience, the more specific the copy. Vague inputs produce copy anyone could have written.
Response shape
You get { job, credits, copy } where copy has six arrays: angles, hooks, headlines, primary_texts, descriptions and ctas. Because it is structured, you can write each field to its own column or map it straight into an ad upload template without parsing prose.
UGC scripts
POST /api/v1/ugc-script takes the same product fields plus length (15, 30 or 60), and optional creator and angle. It returns { job, credits, script } with scenes, spoken lines and on-screen text. Pair it with the image API to make a storyboard frame per scene.
Price
A copy set costs 6 credits by API and a UGC script costs 6 credits (studio price plus 10%, rounded up). Text is powered by Mistral Small 3.1; see the model page.
Patterns that work well
- Fan out by audience: one call per audience segment with the same product, then compare angles.
- Fan out by language: the endpoint supports 15 languages; write each market natively instead of translating one English set.
- Fan out by platform: TikTok hooks and LinkedIn intros are different jobs. Set
platformper call. - Keep the human edit: use the output as a strong first draft and have someone check claims before anything goes live.
Errors and limits
Errors return { error } with 401 (bad key), 402 (not enough credits), 429 (slow down) or 503 (model temporarily unavailable). Retry 429 and 503 with backoff.
From an assistant
The MCP server exposes the same functions as write_ad_copy and write_ugc_script, so you can ask Claude or Cursor to draft copy and it will spend credits from your account. Setup is in MCP with Claude.
Questions
+Which languages are supported?
15 languages. Pass the language in the language field; the copy is written in it rather than translated afterwards.
+Will the API invent claims about my product?
It works from what you send, but any model can overstate. Review claims, prices and guarantees before publishing.
+Can I control tone?
Yes, pass tone such as friendly, premium, playful or professional.
Related
Make your next ad today
Pro is $39.99 a month with 3,000 credits. Cancel anytime.