Create a standalone ad with custom creative
Creates a paid ad with custom creative (headline, body, image/video, link). Creates the full platform campaign hierarchy.
API key authentication - use your Zernio API key as a Bearer token
In: header
length <= 255"engagement" | "traffic" | "awareness" | "video_views""daily" | "lifetime"Required for most platforms. Max: Meta=255, Google=30, Pinterest=100
Google Display only
length <= 90Max: Google=90, Pinterest=500
Meta only
"LEARN_MORE" | "SHOP_NOW" | "SIGN_UP" | "BOOK_TRAVEL" | "CONTACT_US" | "DOWNLOAD" | "GET_OFFER" | "GET_QUOTE" | "SUBSCRIBE" | "WATCH_MORE"uriImage URL (or video URL for TikTok). Not required for Google Search campaigns.
uriGoogle Display only
length <= 25Pinterest only. Board ID (auto-creates if not provided).
13 <= value <= 6513 <= value <= 65Required for lifetime budgets
date-timeCustom audience ID for targeting
Google only
"display""display" | "search"Google Search only
Google Search RSA only. Extra headlines.
Google Search RSA only. Extra descriptions.
Response Body
application/json
application/json
curl -X POST "https://zernio.com/api/v1/ads/create" \ -H "Content-Type: application/json" \ -d '{ "accountId": "string", "adAccountId": "string", "name": "string", "goal": "engagement", "budgetAmount": 0, "budgetType": "daily", "body": "string" }'{
"ad": {
"_id": "string",
"name": "string",
"platform": "facebook",
"status": "active",
"adType": "boost",
"goal": "engagement",
"isExternal": true,
"budget": {
"amount": 0,
"type": "daily"
},
"metrics": {
"spend": 0,
"impressions": 0,
"reach": 0,
"clicks": 0,
"ctr": 0,
"cpc": 0,
"cpm": 0,
"engagement": 0,
"lastSyncedAt": "2019-08-24T14:15:22Z"
},
"platformAdId": "string",
"platformAdAccountId": "string",
"platformCampaignId": "string",
"platformAdSetId": "string",
"campaignName": "string",
"adSetName": "string",
"creative": {},
"targeting": {},
"schedule": {
"startDate": "2019-08-24T14:15:22Z",
"endDate": "2019-08-24T14:15:22Z"
},
"rejectionReason": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
},
"message": "string"
}{
"error": "Unauthorized"
}Search targeting interests GET
Search for interest-based targeting options available on the platform.
Get ad analytics with daily breakdown GET
Returns real-time analytics from the platform API (not cached). Includes summary metrics, daily breakdown, and optional demographic breakdowns (Meta and TikTok only).