API Reference
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.
In: header
Path Parameters
domainId*string
Public UUID of the domain the campaign will belong to
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/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"}