API Evangelist conversational phrasing for Meltwater Listening Search API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Meltwater Listening Search API
  version: 1.0.0
extends: openapi/meltwater-listening-search-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: 1
- target: $.paths['/v3/search/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Search earned media results with a saved search
      effect: read
      questions:
      - How do I pull the actual earned media documents matching my saved search in Meltwater?
      - Can I filter saved search results by sentiment, language or country?
      - Is it possible to page through search results sorted by date?
      instructions:
      - text: Fetch earned media results for saved search {id} in timezone {tz}.
        slots:
          id: path.id
          tz: requestBody.tz
      - text: Get {sentiments} results for saved search {id} from {start} to {end} ({tz}) in {languages}.
        slots:
          sentiments: requestBody.sentiments
          id: path.id
          start: requestBody.start
          end: requestBody.end
          tz: requestBody.tz
          languages: requestBody.languages
      - text: Return page {page} of results for search {id} in {tz}, {page_size} per page, sorted by {sort_by}.
        slots:
          page: requestBody.page
          id: path.id
          tz: requestBody.tz
          page_size: requestBody.page_size
          sort_by: requestBody.sort_by
      method: generated
      generated: '2026-09-26'