Darwin

Darwin Ads API

SDKs and resources to build with Darwin Ads programmatically.

API PlatformDocumentation

Darwin MCP

Buy and manage ad inventory across Darwin's creator network — launch campaigns, browse creators, book placements, and pull analytics conversationally.

01

Campaign Management

Launch, adjust, and optimize — conversationally.

Create campaigns with targeting and budgets, then iterate in real time. Pause underperformers, adjust bids, change schedules — no dashboard needed.

Launch a campaign for our new running shoes targeting fitness audiences, $500/day, optimizing for conversions.
Darwin
Create campaign

Request

{
  "query": "Launch a campaign for our new running sh…"
}

Response

{
  "status": "ok",
  "text": "Campaign "Running Shoes Launch" is live — $50…"
}
Done
Darwin
Generate placements

Request

{
  "query": "Launch a campaign for our new running sh…"
}

Response

{
  "status": "ok",
  "text": "Campaign "Running Shoes Launch" is live — $50…"
}
Done

Campaign "Running Shoes Launch" is live — $500/day budget, targeting fitness and running audiences on YouTube and TikTok. 8 placements auto-booked across top-matched creators. Estimated 180K impressions/day at $2.78 CPM.

02

Inventory Browsing

Find the right creators before spending a dollar.

Search Darwin's creator network by niche, audience demographics, engagement rate, and price. Review full creator profiles before you commit budget.

Find cooking creators with 100K+ followers and engagement above 4% for our kitchen brand.
Darwin
Browse inventory

Request

{
  "query": "Find cooking creators with 100K+ followe…"
}

Response

{
  "status": "ok",
  "text": "Found 22 cooking creators matching your crite…"
}
Done
Darwin
Get creator profile

Request

{
  "query": "Find cooking creators with 100K+ followe…"
}

Response

{
  "status": "ok",
  "text": "Found 22 cooking creators matching your crite…"
}
Done

Found 22 cooking creators matching your criteria. Top 3: @ChefNadia (210K, 6.1% engagement, $14 CPM, 72% female 25-44), @QuickMeals (145K, 5.8%, $11 CPM), @TasteTest (118K, 4.9%, $9 CPM). All have open slots this month.

03

Placement Booking

From discovery to delivery in one prompt.

AI matches your campaign to the best available creator slots based on your objective, audience, and budget. Track delivery status and creator approval in real time.

Book the top 5 cooking creators for our kitchen brand campaign, stay within the $3,000/week budget.
Darwin
Generate placements

Request

{
  "query": "Book the top 5 cooking creators for our …"
}

Response

{
  "status": "ok",
  "text": "Booked 5 placements: @ChefNadia ($840/wk), @Q…"
}
Done
Darwin
List placements

Request

{
  "query": "Book the top 5 cooking creators for our …"
}

Response

{
  "status": "ok",
  "text": "Booked 5 placements: @ChefNadia ($840/wk), @Q…"
}
Done

Booked 5 placements: @ChefNadia ($840/wk), @QuickMeals ($660/wk), @TasteTest ($540/wk), @HomeCook ($520/wk), @BakeWith ($440/wk). Total: $3,000/week, est. 410K impressions. 3 approved, 2 pending.

04

Analytics & Optimization

Know what's working and fix what isn't.

Pull real-time campaign and placement analytics. Get AI recommendations on budget shifts, audience expansions, and underperformer flags.

How is the kitchen brand campaign doing? What should I change?
Darwin
Get campaign analytics

Request

{
  "query": "How is the kitchen brand campaign doing?…"
}

Response

{
  "status": "ok",
  "text": "7 days in: 1.2M impressions, 34K clicks (2.8%…"
}
Done
Darwin
Get insights

Request

{
  "query": "How is the kitchen brand campaign doing?…"
}

Response

{
  "status": "ok",
  "text": "7 days in: 1.2M impressions, 34K clicks (2.8%…"
}
Done

7 days in: 1.2M impressions, 34K clicks (2.8% CTR), 890 conversions, 3.6x ROAS. @ChefNadia is your top performer at 5.1x ROAS. @BakeWith is underdelivering — only 60% of expected impressions. I'd shift $200/wk from @BakeWith to @ChefNadia.

Get started in 3 minutes

Three steps to have AI managing your Darwin Ads campaigns.

1

Sign in with Darwin

Connect once with Darwin OAuth. Your MCP client will reach the same Darwin agent and conversation used by Darwin's other clients.

Sign in to Darwin
2

Add the MCP to your AI client

Open Claude's connector settings and paste these two fields. Darwin OAuth will handle sign-in when your client connects.

NameDarwin MCP
Server URLhttps://mcp.darwin.so/mcp
Add Connector to Claude
3

All set — try it out

Start with a simple read-only prompt to make sure everything is working.

Try thisShow me a summary of my active campaigns and their performance this week.

Tools

Every tool available through Darwin MCP. Your AI picks the right ones automatically based on your request.

Campaignslist_campaigns

List all campaigns with status, daily spend, lifetime spend, impressions, and ROAS.

create_campaign

Create a campaign with name, objective, daily budget, targeting criteria, and schedule.

update_campaign

Edit targeting, bid strategy, schedule, or creative assignments on a live campaign.

pause_campaign

Pause a running campaign or resume a paused one. Optionally reallocate its budget.

Creativeslist_creatives

List creatives with approval status, assigned campaigns, and delivery impressions.

create_creative

Upload a creative — set headline, body copy, CTA, image or video asset, and landing URL.

update_creative

Swap assets, edit copy, or change the landing URL on an existing creative.

Inventorybrowse_inventory

Search creator inventory by niche, platform, audience demographics, engagement rate, and CPM.

get_creator_profile

Full creator profile — follower count, audience breakdown, content categories, and available slots.

generate_placements

AI-match a campaign to optimal creator slots based on objective, audience, and budget.

list_placements

View all booked placements with creator name, delivery status, impressions, and spend.

Analyticsget_campaign_analytics

Campaign metrics by date range — impressions, clicks, CTR, conversions, ROAS, and spend.

get_placement_analytics

Per-placement breakdown — viewability, completion rate, engagement, and attributed conversions.

get_insights

AI-generated recommendations: budget shifts, audience expansions, and underperformer flags.

export_report

Export campaign or placement data as JSON or CSV for stakeholder reporting.

Budgetadjust_budget

Change daily or lifetime budget and pacing speed without interrupting live delivery.

reallocate_budget

Move remaining budget from underperforming placements to top performers automatically.