# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Taboola Backstage Dictionary API version: 1.0.0 extends: openapi/taboola-dictionary-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 16 - target: $.paths['/resources/countries'].get update: x-apievangelist-phrasing: intent: List countries available for targeting effect: read questions: - Which countries can I target with my campaigns? - Where do I find the valid country codes for geo targeting? instructions: - text: List all countries available for targeting. - text: Get the country codes I can use in campaign targeting. method: generated generated: '2026-09-26' - target: $.paths['/resources/countries/{country_code}/regions'].get update: x-apievangelist-phrasing: intent: List regions within a country effect: read questions: - What states or regions can I target inside a country? - Can I get the region names for sub-country targeting? instructions: - text: List the regions in country {country_code}. slots: country_code: path.country_code - text: Show the targetable states or regions for {country_code}. slots: country_code: path.country_code method: generated generated: '2026-09-26' - target: $.paths['/resources/countries/{country_code}/cities'].get update: x-apievangelist-phrasing: intent: List cities within a country effect: read questions: - Which cities can I target in a given country? - Can I get city values to use for city-level targeting? instructions: - text: List the cities in country {country_code}. slots: country_code: path.country_code - text: Show the targetable cities for {country_code}. slots: country_code: path.country_code method: generated generated: '2026-09-26' - target: $.paths['/resources/countries/{country_code}/postal_codes'].get update: x-apievangelist-phrasing: intent: List postal codes for a country effect: read questions: - Can I target ads by zip or postal code? - Where do I get the valid postal codes for a country? instructions: - text: List the postal codes for country {country_code}. slots: country_code: path.country_code - text: Get the targetable zip codes in {country_code}. slots: country_code: path.country_code method: generated generated: '2026-09-26' - target: $.paths['/resources/countries/US/dmas'].get update: x-apievangelist-phrasing: intent: List US DMAs effect: read questions: - Which US designated market areas can I target? - Can I target campaigns by DMA in the United States? instructions: - text: List the US DMAs available for targeting. - text: Show all designated market areas in the United States. method: generated generated: '2026-09-26' - target: $.paths['/resources/browsers'].get update: x-apievangelist-phrasing: intent: List browsers available for targeting effect: read questions: - Which web browsers can I include or exclude in targeting? - What browser values are valid for browser targeting? instructions: - text: List the browsers available for targeting. - text: Get the browser names I can use in a campaign's browser targeting. method: generated generated: '2026-09-26' - target: $.paths['/resources/operating_systems'].get update: x-apievangelist-phrasing: intent: List operating systems for targeting effect: read questions: - Which operating systems can I target my ads to? - What OS values does OS targeting accept? instructions: - text: List the operating systems available for targeting. - text: Show every operating system I can target. method: generated generated: '2026-09-26' - target: $.paths['/resources/operating_systems/ios/versions'].get update: x-apievangelist-phrasing: intent: List iOS versions for targeting effect: read questions: - Can I target specific iOS versions? - Which iPhone OS versions are available in targeting? instructions: - text: List the iOS versions available for targeting. - text: Show the iOS version values I can target. method: generated generated: '2026-09-26' - target: $.paths['/resources/operating_systems/android/versions'].get update: x-apievangelist-phrasing: intent: List Android versions for targeting effect: read questions: - Can I restrict a campaign to certain Android versions? - Which Android OS versions are available in targeting? instructions: - text: List the Android versions available for targeting. - text: Show the Android version values I can target. method: generated generated: '2026-09-26' - target: $.paths['/resources/platforms'].get update: x-apievangelist-phrasing: intent: List device platforms for targeting effect: read questions: - Which device types, like desktop or mobile, can I target? - What platform values are valid for platform targeting? instructions: - text: List the device platforms available for targeting. - text: Show the desktop, mobile and tablet platform codes. method: generated generated: '2026-09-26' - target: $.paths['/resources/languages'].get update: x-apievangelist-phrasing: intent: List supported languages effect: read questions: - What languages are supported for campaigns and content? - Where do I find the valid language codes? instructions: - text: List the supported languages. - text: Get all language codes available on the platform. method: generated generated: '2026-09-26' - target: $.paths['/resources/campaigns/enums'].get update: x-apievangelist-phrasing: intent: List allowed values for campaign fields effect: read questions: - 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? instructions: - text: List the campaign enum values. - text: Show the allowed options for campaign fields like bid type and pricing model. method: generated generated: '2026-09-26' - target: $.paths['/resources/items/enums'].get update: x-apievangelist-phrasing: intent: List allowed values for item fields effect: read questions: - What values are valid for an ad item's CTA or creative focus? - Where can I see the enum options for item fields? instructions: - text: List the item enum values. - text: Show the allowed options for item fields like call to action and status. method: generated generated: '2026-09-26' - target: $.paths['/resources/min_cpc'].get update: x-apievangelist-phrasing: intent: List minimum CPC values effect: read questions: - What's the lowest CPC bid I'm allowed to set? - Do minimum CPC values differ by country or platform? instructions: - text: List the minimum CPC values. - text: Show the minimum cost-per-click bids allowed. method: generated generated: '2026-09-26' - target: $.paths['/{account_id}/dictionary/contextual_segments'].get update: x-apievangelist-phrasing: intent: List contextual segments for an account effect: read questions: - Which contextual segments can my account target? - Can I get the topic-based segments available for contextual targeting? instructions: - text: List the contextual segments available to account {account_id}. slots: account_id: path.account_id - text: Show the contextual targeting segments for {account_id}. slots: account_id: path.account_id method: generated generated: '2026-09-26' - target: $.paths['/{account_id}/dictionary/publishers'].get update: x-apievangelist-phrasing: intent: List publishers available to an account effect: read questions: - Which publisher sites can my ads run on? - Where do I get publisher names to block or allow in targeting? instructions: - text: List the publishers available to account {account_id}. slots: account_id: path.account_id - text: Show the publisher sites I can target or block for {account_id}. slots: account_id: path.account_id method: generated generated: '2026-09-26'