Outbrain

Outbrain Campaigns API

Campaign management

Documentation GitHub OpenAPI

Business capability

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /campaigns/{id} Retrieve a campaign with extra fields · Retrieve a Single Campaign #

Ask an LLM

“How do I see a campaign's CPC, targeting and budget in one call?”

“Can I request extra fields like custom audience when retrieving a campaign?”

Tell an agent

Show campaign {id}.

Retrieve campaign {id} including extra fields {extraFields}.

PUT /campaigns/{id} Update a campaign's CPC, name or targeting · Update an Existing Campaign #

Ask an LLM

“How do I raise the CPC on a running campaign?”

“Can I change a campaign's platform or location targeting after launch?”

Tell an agent

Pause campaign {id}.

Raise the CPC on campaign {id} to 0.70 and exclude ad-block users.

POST /campaigns Create a campaign with budget and targeting · Create a new Campaign #

Ask an LLM

“What do I need to launch a new campaign, like budget and CPC?”

“Can I attach RSS feeds and a tracking code suffix to a new campaign?”

Tell an agent

Create a campaign called Spring Launch on my existing budget with a 0.50 CPC.

Launch a new campaign with desktop-only targeting and my tracking suffix appended.

PUT /campaigns Update up to 25 campaigns at once · Update Multiple Campaigns #

Ask an LLM

“Can I change several campaigns in a single request?”

“What happens if some campaigns in a bulk update fail and others succeed?”

Tell an agent

Pause all ten of my holiday campaigns in one bulk update.

Set the same CPC on this list of campaigns at once.

GET /campaigns/{campaignIds}/multiple Retrieve up to 50 campaigns by ID · Retrieve Multiple Campaigns #

Ask an LLM

“Can I fetch several specific campaigns in one call?”

“How many campaigns can I retrieve by ID at once?”

Tell an agent

Get campaigns {campaignIds}.

Retrieve campaigns {campaignIds} with extra fields {extraFields}.

GET /budgets/{id}/campaigns List campaigns drawing from a budget · List all Campaigns associated with a Budget #

Ask an LLM

“Which campaigns are spending from a particular budget?”

“Is a shared budget attached to more than one campaign?”

Tell an agent

List campaigns on budget {id}.

Show which campaigns share budget {id}.

GET /marketers/{id}/campaigns Filter and page a marketer's campaigns · List all Campaigns associated with a Marketer #

Ask an LLM

“How do I list a marketer's campaigns including archived ones?”

“Can I get only campaigns that changed in the last few days?”

Tell an agent

List campaigns for marketer {id} including archived, {limit} per page.

Show marketer {id} campaigns changed in the last {days} days.

GET /campaigns/{campaignId}/locations Get a campaign's targeted and excluded locations · Retrieve Campaign GeoLocations #

Ask an LLM

“Which countries and regions is my campaign geotargeting?”

“Can I see the locations a campaign excludes?”

Tell an agent

Show the geotargeting for campaign {campaignId}.

List excluded locations on campaign {campaignId}.

GET /marketers/{marketerId}/campaigns List all campaigns belonging to a marketer · List Campaigns For A Marketer #

Ask an LLM

“What campaigns does my marketer account own?”

“Where can I get every campaign for a marketer without filters?”

Tell an agent

List every campaign for marketer {marketerId}.

Give me the names of all campaigns under marketer {marketerId}.

POST /marketers/{marketerId}/campaigns Create a campaign under a marketer with objective · Create A Campaign For A Marketer #

Ask an LLM

“How do I create a campaign under a specific marketer with an objective?”

“Can I set the CPC and budget when adding a campaign to a marketer?”

Tell an agent

Create campaign {name} for marketer {marketerId} with CPC {cpc}.

Add campaign {name} under marketer {marketerId} at CPC {cpc} on budget {budgetId} with objective {objective}.

GET /campaigns/{campaignId} Look up a campaign by its campaign ID · Get A Campaign By Id #

Ask an LLM

“How do I fetch a campaign when all I have is its campaignId?”

“What basic record does a campaign lookup by identifier return?”

Tell an agent

Look up campaign {campaignId}.

Fetch the campaign record with identifier {campaignId}.

PUT /campaigns/{campaignId} Change a campaign's name, CPC, budget or objective · Update A Campaign #

Ask an LLM

“Can I move a campaign to a different budget and change its objective?”

“How do I rename a campaign and set its CPC in one update?”

Tell an agent

Rename campaign {campaignId} to {name} with CPC {cpc}.

Move campaign {campaignId} ({name}, CPC {cpc}) onto budget {budgetId}, enabled set to {enabled}.

Outbrain Campaigns API

Operations 12

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification