API Evangelist conversational phrasing for Taboola Backstage Dictionary API

# 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'