# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Outbrain Amplify Geo Locations API
  version: 1.0.0
extends: openapi/outbrain-geo-locations-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: 3
- target: $.paths['/locations/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search for a geo location to target
      effect: read
      questions:
      - How do I find the location ID for a city I want to geotarget?
      - Can I restrict a location search to one country or require an exact match?
      - Is there a limit on how many location results come back for a term?
      instructions:
      - text: Search geo locations for {term}.
        slots:
          term: query.term
      - text: Find exact matches for location {term} in country {country}, at most {limit} results.
        slots:
          term: query.term
          country: query.country
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations/search/multiple'].post
  update:
    x-apievangelist-phrasing:
      intent: Search several geo location terms at once
      effect: read
      questions:
      - Can I look up several cities and regions in a single location search?
      - What's the way to resolve a whole list of place names to location IDs in one request?
      instructions:
      - text: Look up location IDs for Boston, Chicago and Denver in one batch search.
      - text: Run a multi-term geo location search for the list of regions I give you.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/metadata/supportedLanguages'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported languages
      effect: read
      questions:
      - Which languages does Outbrain support for targeting and location names?
      - What language codes are available?
      instructions:
      - text: List all supported languages.
      - text: Show me the full set of language options the platform accepts.
      method: generated
      generated: '2026-09-26'