Taboola

Taboola Dictionary API

The Dictionary API from Taboola — 16 operation(s) for dictionary.

GitHub OpenAPI

Operations 16

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 /resources/countries List countries available for targeting · Get List Of Countries #
Ask an LLM
“Which countries can I target with my campaigns?”
“Where do I find the valid country codes for geo targeting?”
Tell an agent
List all countries available for targeting.
Get the country codes I can use in campaign targeting.
GET /resources/countries/{country_code}/regions List regions within a country · Get Regions In A Country #
Ask an LLM
“What states or regions can I target inside a country?”
“Can I get the region names for sub-country targeting?”
Tell an agent
List the regions in country {country_code}.
Show the targetable states or regions for {country_code}.
GET /resources/countries/{country_code}/cities List cities within a country · Get Cities In A Country #
Ask an LLM
“Which cities can I target in a given country?”
“Can I get city values to use for city-level targeting?”
Tell an agent
List the cities in country {country_code}.
Show the targetable cities for {country_code}.
GET /resources/countries/{country_code}/postal_codes List postal codes for a country · Get Postal Codes For A Country #
Ask an LLM
“Can I target ads by zip or postal code?”
“Where do I get the valid postal codes for a country?”
Tell an agent
List the postal codes for country {country_code}.
Get the targetable zip codes in {country_code}.
GET /resources/countries/US/dmas List US DMAs · Get DMAs In The US #
Ask an LLM
“Which US designated market areas can I target?”
“Can I target campaigns by DMA in the United States?”
Tell an agent
List the US DMAs available for targeting.
Show all designated market areas in the United States.
GET /resources/browsers List browsers available for targeting · Get List Of Browsers #
Ask an LLM
“Which web browsers can I include or exclude in targeting?”
“What browser values are valid for browser targeting?”
Tell an agent
List the browsers available for targeting.
Get the browser names I can use in a campaign's browser targeting.
GET /resources/operating_systems List operating systems for targeting · Get List Of Operating Systems #
Ask an LLM
“Which operating systems can I target my ads to?”
“What OS values does OS targeting accept?”
Tell an agent
List the operating systems available for targeting.
Show every operating system I can target.
GET /resources/operating_systems/ios/versions List iOS versions for targeting · Get List Of iOS Versions #
Ask an LLM
“Can I target specific iOS versions?”
“Which iPhone OS versions are available in targeting?”
Tell an agent
List the iOS versions available for targeting.
Show the iOS version values I can target.
GET /resources/operating_systems/android/versions List Android versions for targeting · Get List Of Android Versions #
Ask an LLM
“Can I restrict a campaign to certain Android versions?”
“Which Android OS versions are available in targeting?”
Tell an agent
List the Android versions available for targeting.
Show the Android version values I can target.
GET /resources/platforms List device platforms for targeting · Get List Of Platforms #
Ask an LLM
“Which device types, like desktop or mobile, can I target?”
“What platform values are valid for platform targeting?”
Tell an agent
List the device platforms available for targeting.
Show the desktop, mobile and tablet platform codes.
GET /resources/languages List supported languages · Get List Of Languages #
Ask an LLM
“What languages are supported for campaigns and content?”
“Where do I find the valid language codes?”
Tell an agent
List the supported languages.
Get all language codes available on the platform.
GET /resources/campaigns/enums List allowed values for campaign fields · Get List Of Campaign Enums #
Ask an LLM
“What values can I use for fields like bid strategy or marketing objective on a campaign?”
“Where do I find the allowed enum values for campaign settings?”
Tell an agent
List the campaign enum values.
Show the allowed options for campaign fields like bid type and pricing model.
GET /resources/items/enums List allowed values for item fields · Get List Of Item Enums #
Ask an LLM
“What values are valid for an ad item's CTA or creative focus?”
“Where can I see the enum options for item fields?”
Tell an agent
List the item enum values.
Show the allowed options for item fields like call to action and status.
GET /resources/min_cpc List minimum CPC values · Get List Of Minimum CPC Values #
Ask an LLM
“What's the lowest CPC bid I'm allowed to set?”
“Do minimum CPC values differ by country or platform?”
Tell an agent
List the minimum CPC values.
Show the minimum cost-per-click bids allowed.
GET /{account_id}/dictionary/contextual_segments List contextual segments for an account · Get Contextual Segments #
Ask an LLM
“Which contextual segments can my account target?”
“Can I get the topic-based segments available for contextual targeting?”
Tell an agent
List the contextual segments available to account {account_id}.
Show the contextual targeting segments for {account_id}.
GET /{account_id}/dictionary/publishers List publishers available to an account · Get List Of Available Publishers #
Ask an LLM
“Which publisher sites can my ads run on?”
“Where do I get publisher names to block or allow in targeting?”
Tell an agent
List the publishers available to account {account_id}.
Show the publisher sites I can target or block for {account_id}.

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-dictionary-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-dictionary-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/taboola/refs/heads/main/postman/taboola-dictionary-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:taboola-dictionary-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-dictionary-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Taboola Backstage Dictionary API
  version: '1.0'
  description: 'Reference data endpoints used to populate campaign targeting dropdowns and validate field

    values. Provides supported countries, regions, cities, postal codes, DMAs, browsers, operating

    systems, platforms, languages, contextual segments, minimum CPC values, and other enumerations.'
  contact:
    name: Taboola Developer Relations
    url: https://developers.taboola.com/backstage-api/reference/dictionary
servers:
- url: https://backstage.taboola.com/backstage/api/1.0
security:
- bearerAuth: []
tags:
- name: Dictionary
paths:
  /resources/countries:
    get:
      tags:
      - Dictionary
      summary: Get List Of Countries
      operationId: getListOfCountries
      responses:
        '200':
          description: List of supported countries.
  /resources/countries/{country_code}/regions:
    get:
      tags:
      - Dictionary
      summary: Get Regions In A Country
      operationId: getRegionsInCountry
      parameters:
      - $ref: '#/components/parameters/countryCode'
      responses:
        '200':
          description: Regions.
  /resources/countries/{country_code}/cities:
    get:
      tags:
      - Dictionary
      summary: Get Cities In A Country
      operationId: getCitiesInCountry
      parameters:
      - $ref: '#/components/parameters/countryCode'
      responses:
        '200':
          description: Cities.
  /resources/countries/{country_code}/postal_codes:
    get:
      tags:
      - Dictionary
      summary: Get Postal Codes For A Country
      operationId: getPostalCodes
      parameters:
      - $ref: '#/components/parameters/countryCode'
      responses:
        '200':
          description: Postal codes.
  /resources/countries/US/dmas:
    get:
      tags:
      - Dictionary
      summary: Get DMAs In The US
      operationId: getDMAs
      responses:
        '200':
          description: List of US DMAs.
  /resources/browsers:
    get:
      tags:
      - Dictionary
      summary: Get List Of Browsers
      operationId: getListOfBrowsers
      responses:
        '200':
          description: Browsers.
  /resources/operating_systems:
    get:
      tags:
      - Dictionary
      summary: Get List Of Operating Systems
      operationId: getListOfOperatingSystems
      responses:
        '200':
          description: Operating systems.
  /resources/operating_systems/ios/versions:
    get:
      tags:
      - Dictionary
      summary: Get List Of iOS Versions
      operationId: getListOfIosVersions
      responses:
        '200':
          description: iOS versions.
  /resources/operating_systems/android/versions:
    get:
      tags:
      - Dictionary
      summary: Get List Of Android Versions
      operationId: getListOfAndroidVersions
      responses:
        '200':
          description: Android versions.
  /resources/platforms:
    get:
      tags:
      - Dictionary
      summary: Get List Of Platforms
      operationId: getListOfPlatforms
      responses:
        '200':
          description: Platforms.
  /resources/languages:
    get:
      tags:
      - Dictionary
      summary: Get List Of Languages
      operationId: getListOfLanguages
      responses:
        '200':
          description: Languages.
  /resources/campaigns/enums:
    get:
      tags:
      - Dictionary
      summary: Get List Of Campaign Enums
      operationId: getCampaignEnums
      responses:
        '200':
          description: Campaign enums.
  /resources/items/enums:
    get:
      tags:
      - Dictionary
      summary: Get List Of Item Enums
      operationId: getItemEnums
      responses:
        '200':
          description: Item enums.
  /resources/min_cpc:
    get:
      tags:
      - Dictionary
      summary: Get List Of Minimum CPC Values
      operationId: getMinimumCpcValues
      responses:
        '200':
          description: Minimum CPC values by currency.
  /{account_id}/dictionary/contextual_segments:
    get:
      tags:
      - Dictionary
      summary: Get Contextual Segments
      operationId: getContextualSegments
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '200':
          description: Contextual segments.
  /{account_id}/dictionary/publishers:
    get:
      tags:
      - Dictionary
      summary: Get List Of Available Publishers
      operationId: getAvailablePublishers
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '200':
          description: Publishers list.
components:
  parameters:
    accountId:
      name: account_id
      in: path
      required: true
      schema:
        type: string
    countryCode:
      name: country_code
      in: path
      required: true
      schema:
        type: string
        minLength: 2
        maxLength: 2
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT