AdPrompt x402 API
AdPrompt allows small businesses and agencies to plan, create, and launch local marketing campaigns in minutes. Our platform does the heavy lifting so you can focus on helping customers.
If you're a tech savvy lean marketing team, then you can leverage the AdPrompt API endpoints and pay using x402 for only what you need.
How it works
AdPrompt exposes three core API endpoints that implement the x402 payment protocol. Eachrequest follows a simple flow
Having SMART (Specific, Measurable, Achievable, Relevant, Time-bound) goals ensures your campaign stays focused and aligned with your broader business objectives.
Request
Call any endpoint with your payload
Payment required
Receive HTTP 402 with payment details
Pay & execute
Include payment proof in headers, get results
All endpoints return both a polished business-ready report and raw JSON for downstream tools and agents
Endpoint 1: Brand scan
Analyze any brand from just a website URL. Returns a comprehensive brand profile including positioning, target audience, tone & voice, and visual identity.
Input
Analyze any brand from just a website URL. Returns a comprehensive brand profile including positioning, target audience, tone & voice, and visual identity.
1curl -X POST "https://x402.adprompt.io/brand-scan" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "website": "https://example.com"
5 }'Output Location: result.final_result
Contains: scrape, brand_kit, compressed_profile, embedded_profile, plus payment and artifacts metadata
Endpoint 2: Creative generation
Generate publishable image or video creatives for any social platform. Assets are automatically formatted for the selected channel.
What you get
Supported platforms
Instagram, TikTok, Facebook, YouTube, Pinterest, X, LinkedIn, Discord, Snapchat, Reddit, Twitch, WeChat, and more
Input
1curl -X POST "https://api.adprompt.ai/creative-generation" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "business_summary": "Bark n Purr Boise is a locally-owned pet store.",
5 "platform": "instagram",
6 "media_type": "image"
7 }'Output Location: result.final_result
Contains: kind, platform, and items[] where each item includes media_type, url, caption, hashtags,cta.

Endpoint 3: Ad strategy builder
Generate a complete ad strategy with budget allocation, platform recommendations, and KPIs. Works with or without a specified budget.
What you get
Two modes
mode
Supported platforms
Google (Search, Display, Shopping), Facebook, Instagram, YouTube, TikTok, LinkedIn, Pinterest, Snapchat, Reddit, X, Amazon Ads, Spotify, and 15+ more.
1curl -X POST "https://x402.adprompt.io/ad-strategy" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "business_summary": "Bark n Purr Boise is a locally-owned pet
5store.",
6 "location_country": "United States",
7 "budget_usd": null
8 }'1curl -X POST "https://x402.adprompt.io/ad-strategy" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "business_summary": "Bark n Purr Boise is a locally-owned pet
5store.",
6 "location_country": "United States",
7 "budget_usd": 600
8 }'How payment works
All AdPrompt endpoints implement the x402 payment protocol for pay-per-use pricing.
Send your request to any endpoint
Receive HTTP 402 Payment Required
Pay and add proof in next headers.
Receive HTTP 200 with your results
Payment headers
Include payment proof using one of these headers (in order of preference)
Response headers
.png)
Quick reference
Base URL: https://api.adprompt.ai
.png)
.png)
