Outbrain

Outbrain PromotedLinks API

Promoted link (ad creative) management

Documentation GitHub OpenAPI

Business capability

Operations 10

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 /promotedLinks/{id} Retrieve a promoted link with image sizing · Retrieve a Single PromotedLink #

Ask an LLM

“How do I see the headline, image and approval status of one ad?”

“Can I get a promoted link's image back at a specific width and height?”

Tell an agent

Show promoted link {id}.

Get promoted link {id} with its image sized {width} by {height}.

PUT /promotedLinks/{ids} Enable or pause promoted links by ID · Update an Existing PromotedLinks Status #

Ask an LLM

“How do I pause several ads at once using their IDs?”

“Can I switch promoted links back on without touching their CPC?”

Tell an agent

Pause promoted links {ids}.

Turn promoted links {ids} back on.

PUT /campaigns/{campaignId}/promotedLinks Set CPC or status on a campaign's promoted links · Update Existing PromotedLinks CPC Value #

Ask an LLM

“Can I set a different CPC on individual ads within a campaign?”

“How do I change the bid on promoted links in one campaign?”

Tell an agent

Set the CPC of the top ads in campaign {campaignId} to 0.45.

Update the promoted link bid values in campaign {campaignId}.

POST /campaigns/{campaignId}/promotedLinks Create one promoted link in a campaign · Create a PromotedLink #

Ask an LLM

“How do I add a single new ad with my own headline and image to a campaign?”

“What happens if I don't supply an image or headline for a new ad?”

Tell an agent

Add a promoted link for my new blog post to campaign {campaignId} with a custom headline.

Create one ad in campaign {campaignId} using my hosted image and section name.

GET /campaigns/{campaignId}/promotedLinks List all ad creatives in a campaign · List Promoted Links For A Campaign #

Ask an LLM

“What ad creatives are running in my campaign?”

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

Tell an agent

List all ad creatives in campaign {campaignId}.

Give me every promoted link belonging to campaign {campaignId}.

POST /campaigns/{campaignId}/multiplePromotedLinks Create several promoted links in one request · Create multiple PromotedLinks #

Ask an LLM

“Can I upload a batch of new ads to a campaign in one call?”

“Is there a bulk way to create many promoted links with their images?”

Tell an agent

Create these five new ads in campaign {campaignId} in one batch.

Bulk-add promoted links for my article list to campaign {campaignId}.

PUT /campaigns/{campaignId}/promotedLinks/ Bulk-edit up to 500 promoted links · Update multiple PromotedLinks #

Ask an LLM

“Can I change titles and descriptions on hundreds of ads at once?”

“Which ad fields can be edited only while approval status is still editable?”

Tell an agent

Bulk-edit titles, descriptions and logos on the ads in campaign {campaignId}.

Update section names and images for up to 500 promoted links in campaign {campaignId}.

GET /campaigns/{id}/promotedLinks Filter and page a campaign's promoted links · List PromotedLinks for Campaign #

Ask an LLM

“How do I list only the enabled ads in a campaign?”

“Can I filter a campaign's promoted links by approval status and sort them?”

Tell an agent

List enabled promoted links in campaign {id} with status {statuses}.

Page through campaign {id} ads {limit} at a time sorted by {sort}.

GET /promotedLinks/{promotedLinkId} Look up a promoted link by its identifier · Get A Promoted Link By Id #

Ask an LLM

“How do I fetch an ad when all I have is its promotedLinkId?”

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

Tell an agent

Look up promoted link {promotedLinkId}.

Fetch the ad record with identifier {promotedLinkId}.

PUT /promotedLinks/{promotedLinkId} Change a promoted link's text, URL or image · Update A Promoted Link #

Ask an LLM

“How do I change the landing page URL on one of my ads?”

“Can I replace an ad's headline text and image URL?”

Tell an agent

Change promoted link {promotedLinkId} to text {text} and URL {url}.

Update promoted link {promotedLinkId} with headline {text}, link {url} and image {imageUrl}.

Outbrain PromotedLinks API

Operations 10

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