Taboola

Taboola Campaigns API

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

GitHub OpenAPI

Operations 6

GET /{account_id}/campaigns/ Get All Campaigns #
POST /{account_id}/campaigns/ Create A Campaign #
GET /{account_id}/campaigns/{campaign_id} Get A Campaign #
POST /{account_id}/campaigns/{campaign_id} Update A Campaign #
DELETE /{account_id}/campaigns/{campaign_id} Delete A Campaign #
POST /{account_id}/campaigns/{campaign_id}/duplicate Duplicate A Campaign #

Documentation

📖
Documentation
https://developers.taboola.com/backstage-api/reference/campaigns-overview
📖
Documentation
https://developers.taboola.com/backstage-api/reference/create-a-campaign
📖
Documentation
https://developers.taboola.com/backstage-api/reference/campaign-items-overview
📖
Documentation
https://developers.taboola.com/backstage-api/reference/audience-targeting
📖
Documentation
https://developers.taboola.com/backstage-api/reference/onboarding-overview
📖
Documentation
https://developers.taboola.com/backstage-api/reference/conversion-rule-fields
📖
Documentation
https://developers.taboola.com/conversion-tracking
📖
Documentation
https://developers.taboola.com/backstage-api/reference
📖
Documentation
https://developers.taboola.com/backstage-api/reference/dictionary
📖
Documentation
https://developers.taboola.com/backstage-api/reference/get-allowed-accounts

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/openapi/taboola-campaigns-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/json-schema/taboola-campaign-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/json-schema/taboola-item-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/json-schema/taboola-conversion-rule-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/json-ld/taboola-context.jsonld
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/overlays/taboola-campaigns-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/postman/taboola-campaigns-api.postman_collection.json
🔗
MCPServer
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/mcp/taboola-mcp.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/mcp/taboola-tool-crosswalk.yml

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-campaigns-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

taboola-campaigns-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Taboola Backstage Accounts Campaigns API
  version: '1.0'
  description: 'Access and search advertiser accounts within a Taboola network. Used by ad ops platforms and

    agencies managing multiple advertiser accounts under a Taboola network account.'
  contact:
    name: Taboola Developer Relations
    url: https://developers.taboola.com/backstage-api/reference
servers:
- url: https://backstage.taboola.com/backstage/api/1.0
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