AdMakeAI
AdMakeAI's full REST API covers account and project management, brand and competitor research, image, copy, ad-set and video generation, uploads, and connected Meta campaign and analytics workflows. Video, commercial-use, and Meta operations require a paid AdMakeAI plan; Meta operations also require a Facebook/Meta account connected inside AdMakeAI.
Tools (60)
Add Competitors
Persist competitors on a project and, by default, start asynchronous ad scraping for them. The connector exposes no delete or cleanup operation for the created competitor records or scrape effects.
Inputs: project_id, scrape_ads, competitors
Create Ad Set
Create and persist an ad-set configuration from a project, shared creative brief, format, quality, aspect ratio, references, and optional copy guidance. This write is free, but the saved quality determines future batch-generation cost: 2 credits per image for low, 8 for high, or 20 for ultra. AdMakeAI documents no ad-set deletion endpoint, so this resource cannot be cleaned up through the API. Obtain confirmation before creating it.
Inputs: name, ad_type, quality, project_id, aspect_ratio, ad_copy_instructions, general_instructions, additional_image_urls, ad_copy_messaging_style
Create First Project
Create the connected account's first brand project by analyzing a user-supplied website URL. Call List Projects first and use this action only when it returns no projects. The operation takes about 10-15 seconds, persists the project and generated brand brief, and cannot be cleaned up through the API because AdMakeAI documents no project deletion endpoint.
Inputs: website_url
Create Meta Draft Campaign
Create real Meta campaign, ad-set, and ad objects from explicit campaign data, copy, and externally hosted image or video URLs. All objects land paused. Obtain explicit user confirmation immediately before calling. Nothing launches or spends until the user acts in Meta Ads Manager. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: ad_sets, page_id, campaign, ad_account_id, connection_id
Design An Ad
Queue a persistent finished-ad render. AdMakeAI rewrites the creative brief using the project's brand context and adds a headline, subline, CTA, and logo when available; use Render Image From Exact Prompt when those additions are unwanted. This operation spends credits, but the official API does not publish the amount. Results persist and the connector exposes no delete operation. Obtain confirmation before calling, then poll with Get Image Generation.
Inputs: prompt, ad_type, quality, ad_set_id, project_id, aspect_ratio, input_image_id, reference_ad_id, reference_image_urls, reference_inspiration_id
Edit Ad Image
Queue a persistent image-to-image edit from a generated-ad ID or direct image URL. This operation spends credits, but the official API does not publish the amount. Results persist and the connector exposes no delete operation. Obtain confirmation before calling, then poll with Get Image Generation.
Inputs: quality, project_id, aspect_ratio, source_ad_id, source_image_url, edit_instructions
Generate Ad Copy
Generate 1-5 Facebook or Instagram copy variations for a completed ad image, including the provider's headline, primary text, description, call to action, hook angle, and identifiers. AdMakeAI's official API does not publish the credit cost for this operation. The generated output is persistent, and AdMakeAI documents no ad-copy deletion endpoint.
Inputs: image_url, project_id, messaging_style, variation_count, additional_instructions
Generate Ad Set Batch
Queue 1, 2, 4, 6, 8, or 15 image variations from an existing ad set. The operation spends count x 2 credits at low quality, count x 8 at high, or count x 20 at ultra, and returns the queued generation data. Each variation is a persistent generation record; AdMakeAI documents no API endpoint for deleting those records. Poll each returned generation ID with Get Image Generation.
Inputs: count, quality, ad_set_id, specific_instructions
Render Image From Exact Prompt
Queue a persistent image render from the prompt exactly as written, without a creative-director rewrite, brand brief, added copy, CTA, or logo. Use Design Ad instead for a finished brand-directed ad. This operation spends credits; the official API does not publish the amount. Results persist and the connector exposes no delete operation. Obtain confirmation before calling, then poll the returned generation ID with Get Image Generation.
Inputs: prompt, quality, project_id, aspect_ratio, input_image_id, reference_image_urls
Get Account Profile
Get the connected AdMakeAI user's profile, plan, and current credit balance.
Get Competitor Ad
Get one scraped competitor ad in full, including provider-returned creative URLs, ad text, headline, run dates, and platform placements.
Inputs: project_id, scraped_ad_id
Get Ad Set
Get one ad set by ID, including its shared creative instructions.
Inputs: ad_set_id
Get Advertiser's Live Ads
Get a Facebook page's currently running Meta Ad Library ads by page ID. This works for any advertiser, not only saved competitors.
Inputs: cursor, country, page_id
Preview Competitor Ads
Preview the ads already scraped for one persisted competitor.
Inputs: competitor_id
Get Credit Balance
Get the connected AdMakeAI user's current credit balance.
Get Image Generation
Get one image generation's status, prompt, and result URLs by ID; call repeatedly until status is COMPLETED or a terminal failure is returned.
Inputs: generation_id
Get Ad Account Overview
Read total Meta ad-account spend, impressions, clicks, CTR, CPC, conversions, and ROAS for a date range, optionally with previous-period comparison. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: to_date, from_date, date_preset, ad_account_id, connection_id, compare_to_previous
Get Meta Ad
Read one Meta ad's metadata and creative without changing it. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: ad_id, connection_id
Get Ad Daily Analytics
Read day-by-day spend, CTR, CPC, conversions, and other preserved analytics for one Meta ad. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: ad_id, to_date, from_date, breakdowns, connection_id
Get Ad Comments
Read one page of public comments on the Facebook or Instagram post behind a Meta ad. Pass only a continuation cursor actually returned by the provider. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: ad_id, limit, cursor, placement, connection_id
Get Campaign Draft
Read a saved agent-created Facebook campaign draft before pushing it. This read requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; those are provider-side prerequisites.
Inputs: draft_id
Get Campaign Structure
Read the Meta campaign, ad-set, and ad hierarchy for an ad account. Advance page only when the preserved provider payload indicates more results. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: page, sort, limit, status, to_date, from_date, ad_account_id, connection_id
Get Performance Timeline
Read time-series performance metrics for a Meta ad account. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: to_date, from_date, ad_account_id, connection_id
Get Meta upload
Get one uploaded ad's current upload state and Meta IDs. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
Inputs: uploadedAdId
Get Project Brief
Get one project with its complete brand brief, competitors, research jobs, and scraped-ad counts before generating brand-matched creative.
Inputs: project_id
Get Research Status
Poll a project's research pipeline stage, running asynchronous scrape jobs, competitor count, and saved-ad count.
Inputs: project_id
Get Video Generation Status
Poll one persistent video generation until status is COMPLETED or a terminal failure, returning its untyped status and output data. The underlying video requires an active paid AdMakeAI subscription and cost 5/15/50 credits at low/medium/high quality when queued. This read spends no credits and creates nothing; AdMakeAI exposes no video-generation delete operation.
Inputs: generation_id
List Ad Copy Styles
List the messaging styles accepted by Generate Ad Copy, including professional, UGC, direct-response, and storytelling styles.
List Ads
List the account's persistent ad generations newest first, one page at a time.
Inputs: limit, cursor
List Ads In Ad Set
Return one page of image generations belonging to an ad set, optionally filtered by like or download state. Advance page only when the preserved provider payload indicates more results.
Inputs: page, filter, per_page, ad_set_id
List Ad Sets
Return one page of the connected account's ad sets. Advance the one-based page value only when the preserved provider payload indicates more results.
Inputs: page, per_page
List Facebook connections
List connected Facebook ad accounts and Pages with cached identity details. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
List Ad Performance
Read Meta ads, optionally under a campaign, with performance metrics. Advance page only when the preserved provider payload indicates more results. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: page, sort, limit, status, campaign_id, ad_account_id, connection_id
List campaign ad sets
List Meta ad sets under a campaign. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
Inputs: refresh, adAccountId, fbCampaignId
List Campaign Performance
Read Meta campaigns with rolled-up performance metrics. Advance page only when the preserved provider payload indicates more results. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI.
Inputs: page, sort, limit, status, to_date, from_date, ad_account_id, connection_id
List ad account campaigns
List Meta campaigns for a connected ad account, refreshing from Meta when requested. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
Inputs: refresh, adAccountId
List Meta uploads
List previously uploaded Meta ads, optionally filtered by account, generation, state, or search text. Pass a provider-returned cursor to continue. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
Inputs: limit, cursor, search, adAccountId, uploadState, adGenerationId
List Pending Ads
List the account's currently pending persistent ad generations.
Inputs: ad_set_id
List Pending Videos
List currently rendering persistent video generations, optionally by video set. Video resources require an active paid AdMakeAI subscription and cost 5/15/50 credits per low/medium/high video when queued; this read spends no credits. AdMakeAI exposes no video-generation delete operation. Poll each ID with Get Video Generation Status until COMPLETED or a terminal failure.
Inputs: video_set_id
List Project Assets
List a project's stored product photos and logos with their IDs and URLs for use as image-generation references.
Inputs: project_id
List Projects
List the user's brand projects. Call this before generation to obtain a project ID; if no projects exist, ask for the brand website before creating one.
Inputs: limit, cursor
List Recent Ads
Get up to 20 of the account's most recent persistent ad generations.
Inputs: limit
Get Reusable Meta Creatives
Resolve previously uploaded Meta ads into reusable creative assets for a campaign draft. This read requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; those are provider-side prerequisites.
Inputs: ad_account_id, connection_id, zernio_ad_ids, platform_ad_ids
List Saved Inspirations
List competitor ads saved as inspiration, optionally for one project, with limit and offset pagination. Advance offset by the returned page length.
Inputs: limit, offset, project_id
Browse Competitor Ads
Browse competitor ads scraped into a project with media, keyword, relevance, sorting, limit, and offset controls. Advance offset by the returned page length.
Inputs: limit, offset, search, sort_by, media_type, project_id, search_term, competitor_id, show_irrelevant
List Uploaded Images
List one page of the connected user's persistent uploaded source images, newest first. Pass the provider's returned nextCursor as cursor to continue.
Inputs: limit, cursor
List Video Ads
Return one page of completed persistent UGC video ads. Video resources require an active paid AdMakeAI subscription and cost 5/15/50 credits per low/medium/high video when queued; this list read spends no credits. AdMakeAI exposes no video-generation delete operation. Use Get Video Generation Status to poll a known generation, and advance page only when the payload indicates more.
Inputs: page, filter, per_page, project_id, video_set_id
Push Campaign Draft to Meta
Push a saved campaign draft to Meta, creating real campaign, ad-set, and ad objects in paused state. Obtain explicit user confirmation immediately before calling. Nothing launches or spends until the user acts in Meta Ads Manager. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; those are provider-side prerequisites.
Inputs: draft_id
Upload ad to Meta
Create a real Meta ad from an AdMakeAI creative. The created Meta objects land paused, but this irreversible external write costs 3 AdMakeAI credits. Obtain the user's explicit confirmation immediately before every call. Nothing launches or spends on Meta until the user acts in Meta Ads Manager. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials. Run the non-creating Meta upload preflight first.
Inputs: adCopy, targetPageId, targetAdSetId, adGenerationId, destinationUrl, templateOverrides, targetInstagramActorId, confirmedReadinessDismissals
Check ad before Meta upload
Perform non-creating validation of an ad creative, copy, destination, and target ad set. This preflight does not upload or create a Meta ad. Requires a paid AdMakeAI plan and a Facebook/Meta account connected inside AdMakeAI; these are provider-side prerequisites, not additional credentials.
Inputs: adCopy, targetAdSetId, adGenerationId, destinationUrl, declareAsAiGenerated
Save Ad as Inspiration
Persist a scraped competitor ad as project inspiration for later remixing. The connector exposes no delete or cleanup operation for the saved inspiration.
Inputs: action, project_id, user_notes, scraped_ad_id
Refresh Competitor Ads
Start an asynchronous re-scrape of one competitor's live Facebook ads into the project, then poll Get Research Status. Scraped results persist, and the connector exposes no delete or cleanup operation for the job or its effects.
Inputs: competitor_id
Search Ads
Search and page through the connected account's generated-ad history by prompt and favorite/download state, newest matches first.
Inputs: limit, query, cursor, filter
Find Advertiser Page
Resolve a brand name to Facebook advertiser pages with page IDs, names, categories, and provider-returned follower counts.
Inputs: query
Create UGC Video Ad
Queue 1-10 persistent UGC-style video-ad jobs. An active paid AdMakeAI subscription is required. Each video costs 5 credits at low quality, 15 at medium, or 50 at high. AdMakeAI exposes no video-generation delete operation. Obtain confirmation before spending credits, then poll each returned ID with Get Video Generation Status until COMPLETED or a terminal failure.
Inputs: engine, quality, project_id, video_count, user_instructions, starting_frame_url, reference_image_url, generate_starting_frame
Suggest Ad Set Directions
Create distinct model-generated creative angles for an ad set to use as per-variation instructions. This produces persistent provider output, and AdMakeAI documents no API deletion operation; obtain confirmation first.
Inputs: exclude, ad_set_id
Toggle Ad Favorite
Star or unstar one persistent ad generation. This changes provider state, though it does not spend generation credits. Obtain confirmation before calling.
Inputs: id
Update Ad Set
Persist changes to an ad set before generating another batch. Future image generation costs 2 credits per image for low quality, 8 for high, or 20 for ultra. AdMakeAI documents no ad-set deletion endpoint, so obtain confirmation before changing the resource.
Inputs: name, ad_type, quality, ad_set_id, aspect_ratio, ad_copy_instructions, general_instructions, additional_image_urls, ad_copy_messaging_style
Update Project Brief
Update a project's persistent brand brief, including its product summary, target audience, value proposition, industry, and keywords. The changes affect later generations, and AdMakeAI documents no project deletion endpoint.
Inputs: industry, keywords, project_id, product_summary, target_audience, value_proposition
Upload Image
Upload a base64-encoded JPEG, PNG, or WebP image to persistent AdMakeAI storage and return its image ID and public URL. AdMakeAI documents no uploaded-image deletion endpoint.
Inputs: filename, image_hash, base64_data, content_type, turnstile_token