Taboola

Taboola Campaigns API

Create, retrieve, update, duplicate, and delete advertising campaigns.

Documentation GitHub OpenAPI

Business capability

Operations 6

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 /{account_id}/campaigns/ List all campaigns in an account · Get All Campaigns #

Ask an LLM

“How do I see all the campaigns in my advertiser account?”

“Can I list every campaign with its budget and status for one account?”

Tell an agent

List all campaigns in account {account_id}.

Show me every campaign under advertiser {account_id}.

POST /{account_id}/campaigns/ Create a new advertising campaign · Create A Campaign #

Ask an LLM

“How do I launch a new campaign with a CPC bid and daily cap?”

“Can I set country and platform targeting when creating a campaign?”

Tell an agent

Create a campaign named {name} in account {account_id} with a CPC of {cpc}.

Set up a new campaign {name} with branding text {branding_text} and a spending limit of {spending_limit}.

GET /{account_id}/campaigns/{campaign_id} Get one campaign's settings · Get A Campaign #

Ask an LLM

“How do I look up a single campaign by its ID?”

“Can I check how much a specific campaign has spent so far?”

Tell an agent

Get campaign {campaign_id} in account {account_id}.

Show the targeting, bid and budget for campaign {campaign_id}.

POST /{account_id}/campaigns/{campaign_id} Update an existing campaign · Update A Campaign #

Ask an LLM

“How do I change the CPC bid on a campaign that's already running?”

“Can I pause an existing campaign by turning it inactive?”

Tell an agent

Change the CPC of existing campaign {campaign_id} in account {account_id} to {cpc}.

Set the daily cap on campaign {campaign_id} to {daily_cap}.

DELETE /{account_id}/campaigns/{campaign_id} Terminate a campaign · Delete A Campaign #

Ask an LLM

“How do I permanently delete a campaign?”

“What happens to a campaign after it's marked terminated?”

Tell an agent destructive · confirm first

Delete campaign {campaign_id} from account {account_id}.

Terminate campaign {campaign_id} for good.

POST /{account_id}/campaigns/{campaign_id}/duplicate Duplicate an existing campaign · Duplicate A Campaign #

Ask an LLM

“Can I copy an existing campaign instead of rebuilding it from scratch?”

“Is it possible to clone a campaign into a different advertiser account?”

Tell an agent

Duplicate campaign {campaign_id} in account {account_id}.

Make a copy of campaign {campaign_id} with its settings.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/taboola:taboola-campaigns-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Taboola Backstage Campaigns API
  version: '1.0'
  description: 'Programmatic interface for managing Taboola Realize advertising campaigns. The Backstage Campaigns

    surface provides CRUD operations for campaigns at the account level, plus bulk and network-wide

    convenience endpoints. Used by advertisers and ad operations platforms to integrate Taboola native

    and discovery campaign management.'
  contact:
    name: Taboola Developer Relations
    url: https://developers.taboola.com/backstage-api/reference
  license:
    name: Proprietary
    url: https://www.taboola.com/legal-policies
servers:
- url: https://backstage.taboola.com/backstage/api/1.0
  description: Production
security:
- bearerAuth: []
tags:
- name: Campaigns
  description: Create, retrieve, update, duplicate, and delete advertising campaigns.
paths:
  /{account_id}/campaigns/:
    get:
      tags:
      - Campaigns
      summary: Get All Campaigns
      description: Get all campaigns for the specified account.
      operationId: getAllCampaigns
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '200':
          description: List of campaigns.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Campaign'
    post:
      tags:
      - Campaigns
      summary: Create A Campaign
      description: Create a new campaign under the specified account.
      operationId: createCampaign
      parameters:
      - $ref: '#/components/parameters/accountId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Campaign'
      responses:
        '200':
          description: The created campaign.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
  /{account_id}/campaigns/{campaign_id}:
    get:
      tags:
      - Campaigns
      summary: Get A Campaign
      description: Get a specific campaign by ID.
      operationId: getCampaign
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: '#/components/parameters/campaignId'
      responses:
        '200':
          description: A single campaign.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
    post:
      tags:
      - Campaigns
      summary: Update A Campaign
      description: Update an existing campaign. Fields omitted or null will not be updated.
      operationId: updateCampaign
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: '#/components/parameters/campaignId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Campaign'
      responses:
        '200':
          description: Updated campaign.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
    delete:
      tags:
      - Campaigns
      summary: Delete A Campaign
      description: Mark the campaign as TERMINATED. Subsequent references return 404.
      operationId: deleteCampaign
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: '#/components/parameters/campaignId'
      responses:
        '200':
          description: Campaign object with status=TERMINATED.
  /{account_id}/campaigns/{campaign_id}/duplicate:
    post:
      tags:
      - Campaigns
      summary: Duplicate A Campaign
      description: Duplicate an existing campaign optionally overriding fields and target account.
      operationId: duplicateCampaign
      parameters:
      - $ref: '#/components/parameters/accountId'
      - $ref: '#/components/parameters/campaignId'
      responses:
        '200':
          description: Newly created campaign.
components:
  schemas:
    Targeting:
      type: object
      properties:
        type:
          type: string
          enum:
          - INCLUDE
          - EXCLUDE
          - ALL
        value:
          type: array
          items:
            type: string
        href:
          type: string
    Campaign:
      type: object
      properties:
        id:
          type: string
          description: Unique campaign identifier.
        advertiser_id:
          type: string
        name:
          type: string
        branding_text:
          type: string
        tracking_code:
          type: string
        cpc:
          type: number
          format: float
        spending_limit:
          type: number
          format: float
        spending_limit_model:
          type: string
          enum:
          - ENTIRE
          - DAILY
          - MONTHLY
        daily_cap:
          type: number
          format: float
        daily_ad_delivery_model:
          type: string
          enum:
          - STABLE
          - ACCELERATED
        start_date:
          type: string
          format: date
        end_date:
          type: string
          format: date
        is_active:
          type: boolean
        status:
          type: string
          enum:
          - RUNNING
          - PAUSED
          - PENDING_APPROVAL
          - REJECTED
          - TERMINATED
          - EXPIRED
          - FROZEN
        approval_state:
          type: string
        marketing_objective:
          type: string
          enum:
          - ONLINE_PURCHASES
          - LEADS_GENERATION
          - DRIVE_WEBSITE_TRAFFIC
          - BRAND_AWARENESS
          - MOBILE_APP_INSTALL
        bid_strategy:
          type: string
          enum:
          - FIXED
          - SMART
          - MAX_CONVERSIONS
          - TARGET_CPA
        bid_type:
          type: string
          enum:
          - CPC
          - CPM
          - VCPM
        pricing_model:
          type: string
        cpa_goal:
          type: number
          format: float
        country_targeting:
          $ref: '#/components/schemas/Targeting'
        sub_country_targeting:
          $ref: '#/components/schemas/Targeting'
        platform_targeting:
          $ref: '#/components/schemas/Targeting'
        browser_targeting:
          $ref: '#/components/schemas/Targeting'
        os_targeting:
          $ref: '#/components/schemas/Targeting'
        publisher_targeting:
          $ref: '#/components/schemas/Targeting'
        contextual_segments_targeting:
          $ref: '#/components/schemas/Targeting'
        custom_audience_targeting:
          $ref: '#/components/schemas/Targeting'
        lookalike_audience_targeting:
          $ref: '#/components/schemas/Targeting'
        audience_segments_multi_targeting:
          type: object
        spent:
          type: number
          format: float
  parameters:
    campaignId:
      name: campaign_id
      in: path
      required: true
      schema:
        type: string
      description: Campaign identifier.
    accountId:
      name: account_id
      in: path
      required: true
      schema:
        type: string
      description: Taboola account identifier.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'OAuth 2.0 client credentials access token. Obtain via POST to

        https://backstage.taboola.com/backstage/oauth/token with `grant_type=client_credentials`,

        `client_id`, and `client_secret`.'

Taboola Campaigns API

Operations 6

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