Agency API · v1

Conversational Ad Cards API

One authenticated POST instantly generates three conversational ad cards — tailored for ChatGPT, Perplexity and Apple Intelligence chat-interface layouts — and saves them as drafts in the owning workspace for approval.

Endpoint

POST https://montjoysynapse.com/api/public/v1/generate-ad-cards

Auth: Authorization: Bearer ms_live_…. Create and revoke keys in your account settings. Keys are shown once and stored only as a hash.

Request body (Zod-validated)

target_url — string, must be a valid URL. The public page we crawl for entity signals.
industry — string, 2–80 chars (e.g. roofing, lawyer, hvac).
zip — string, exactly 5 digits.
company_name — optional string, up to 200 chars.

Example request

curl -X POST https://montjoysynapse.com/api/public/v1/generate-ad-cards \
  -H "Authorization: Bearer ms_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://premierroofingsuwanee.com",
    "industry": "roofing",
    "zip": "30024",
    "company_name": "Premier Roofing Suwanee"
  }'

200 response

{
  "chatgpt_card": "Premier Roofing Suwanee is a licensed…",
  "perplexity_card": "- Storm-damage specialists in Suwanee, GA [1]…",
  "apple_card": "Premier Roofing Suwanee — licensed roofing contractor…",
  "ad_card_ids": [
    "0f6b…", "9c21…", "44ad…"
  ]
}

Errors

401 — missing, malformed, revoked or unknown API key.
400 — body is not JSON, or fails schema validation (details included).
500 — cards generated but could not be persisted; retry safely.