Propose ad creatives for the prompts being claimed on a topic
Writes one ad per prompt, grounded in the brand's stored description and in the ads already observed on the topic. Nothing is crawled.
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringPublic UUID of the domain the campaign will belong to
application/json- body
topicId*stringTopic the campaign defends
topicName*stringTopic name, used as generation context
market?stringMarket of the topic. Claims are topic-scoped, and a topic's market can differ from its domain's, so the domain market is only a fallback
prompt*stringThe claimed prompt the whole campaign is built from
posture*stringThe move this campaign makes, from the prefill. Every ad group is a facet of it, never a different posture beside it
"defend""attack""open-ground"situation?stringThe prompt's classified strategic position, used to explain the plan. An open monetised prompt is generated as Enter and never names a competitor
"contested-stronghold""quiet-stronghold""rival-owned""open-monetised""unclaimed"competitorNames?array<string>Competitor names observed on the topic, used as generation context
criterion?stringEvaluation-criterion catalogue slug the campaign strikes back on: the brand attribute where ChatGPT picks a competitor over the brand. Every ad group argues the brand's case on it
"price""value-for-money""product-quality""reliability""performance""features""ease-of-use""design""innovation""customer-service""technical-support""onboarding""reputation""availability""product-range""integrations""security-privacy""sustainability""efficacy""ingredients""comfort""safety""location""atmosphere""cleanliness""speed-of-service""personalization""prestige""exclusivity""heritage""expertise""ethics"One suggestion per prompt, in the order the prompts were given
application/json- response
groups*array<>One ad group per surviving posture, in plan order
prompt*stringThe claimed prompt the plan was built from, echoed back for the image requests
brandName*stringBrand name the plan was written for
industry?stringIndustry of the brand
curl -X POST 'https://api.getmint.ai/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/ads/creative-suggestions' \ -H 'Content-Type: application/json' \ -d '{ "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "topicName": "Athletic Footwear", "prompt": "best running shoes for flat feet", "posture": "defend"}'{ "groups": [ { "posture": "defend", "section": "defend", "name": "Core answer", "description": "The question itself and the ways people ask it.", "hints": [ { "category": "category-term", "text": "AI visibility platform" } ], "ads": [ { "headline": "Support Built In", "description": "Stability shoes with a wider platform, built for flat arches." } ] } ], "prompt": "best running shoes for flat feet", "brandName": "Nike", "industry": "Athletic footwear"}