Microsoft Azure News Search Client — NewsTrendingTopics

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure News Search Client — NewsTrendingTopics
  description: 'Microsoft Azure News Search Client — NewsTrendingTopics. 1 operations. Lead operation: Microsoft Azure The
    News Trending Topics Api Lets You Search On Bing And Get Back A List Of Trending News Topics That Are Currently Trending
    On Bing This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request News And
    The Json Response Objects That Contain Them  For Exa'
  tags:
  - Microsoft Azure
  - NewsTrendingTopics
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: news-search-client-newstrendingtopics
    baseUri: https://api.cognitive.microsoft.com/bing/v7.0
    description: Microsoft Azure News Search Client — NewsTrendingTopics business capability. Self-contained, no shared references.
    resources:
    - name: news-trendingtopics
      path: /news/trendingtopics
      operations:
      - name: microsoftazurenewstrending
        method: GET
        description: Microsoft Azure The News Trending Topics Api Lets You Search On Bing And Get Back A List Of Trending
          News Topics That Are Currently Trending On Bing This Section Provides Technical Details About The Query Parameters
          And Headers That You Use
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Accept
          in: header
          type: string
          description: The default media type is application/json. To specify that the response use [JSON-LD](http://json-ld.org/),
            set the Accept header to application/ld+json.
        - name: Accept-Language
          in: header
          type: string
          description: A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing
            order of preference. For additional information, in
        - name: User-Agent
          in: header
          type: string
          description: 'The user agent originating the request. Bing uses the user agent to provide mobile users with an optimized
            experience. Although optional, you are encouraged to '
        - name: X-MSEdge-ClientID
          in: header
          type: string
          description: 'Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often
            flights new features and improvements, and it uses the client '
        - name: X-MSEdge-ClientIP
          in: header
          type: string
          description: The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location.
            Bing uses the location information to determine safe sear
        - name: X-Search-Location
          in: header
          type: string
          description: A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing
            uses the location information to determine safe search beha
        - name: cc
          in: query
          type: string
          description: 'A 2-character country code of the country where the results come from. This API supports only the
            United States market. If you specify this query parameter, it '
        - name: count
          in: query
          type: integer
          description: The number of news articles to return in the response. The actual number delivered may be less than
            requested. The default is 10 and the maximum value is 100. T
        - name: mkt
          in: query
          type: string
          description: The market where the results come from. Typically, mkt is the country where the user is making the
            request from. However, it could be a different country if the
        - name: offset
          in: query
          type: integer
          description: The zero-based offset that indicates the number of news to skip before returning news. The default
            is 0. The offset should be less than ([totalEstimatedMatches]
        - name: safeSearch
          in: query
          type: string
          description: 'Filter news for adult content. The following are the possible filter values. Off: Return news articles
            with adult text, images, or videos. Moderate: Return news'
        - name: setLang
          in: query
          type: string
          description: The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language
            code. For example, the language code for English is E
        - name: since
          in: query
          type: integer
          description: The Unix epoch time (Unix timestamp) that Bing uses to select the trending topics. Bing returns trending
            topics that it discovered on or after the specified dat
        - name: sortBy
          in: query
          type: string
          description: 'The order to return the news in. The following are the possible case-insensitive values. Date: If
            the request is through the News Search API, the response retur'
        - name: textDecorations
          in: query
          type: boolean
          description: A Boolean value that determines whether display strings contain decoration markers such as hit highlighting
            characters. If true, the strings may include markers
        - name: textFormat
          in: query
          type: string
          description: The type of markers to use for text decorations (see the textDecorations query parameter). Possible
            values are Raw—Use Unicode characters to mark content that n
  exposes:
  - type: rest
    namespace: news-search-client-newstrendingtopics-rest
    port: 8080
    description: REST adapter for Microsoft Azure News Search Client — NewsTrendingTopics. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/news/trendingtopics
      name: news-trendingtopics
      description: REST surface for news-trendingtopics.
      operations:
      - method: GET
        name: microsoftazurenewstrending
        description: Microsoft Azure The News Trending Topics Api Lets You Search On Bing And Get Back A List Of Trending
          News Topics That Are Currently Trending On Bing This Section Provides Technical Details About The Query Parameters
          And Headers That You Use
        call: news-search-client-newstrendingtopics.microsoftazurenewstrending
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          User-Agent: rest.User-Agent
          X-MSEdge-ClientID: rest.X-MSEdge-ClientID
          X-MSEdge-ClientIP: rest.X-MSEdge-ClientIP
          X-Search-Location: rest.X-Search-Location
          cc: rest.cc
          count: rest.count
          mkt: rest.mkt
          offset: rest.offset
          safeSearch: rest.safeSearch
          setLang: rest.setLang
          since: rest.since
          sortBy: rest.sortBy
          textDecorations: rest.textDecorations
          textFormat: rest.textFormat
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: news-search-client-newstrendingtopics-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure News Search Client — NewsTrendingTopics. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-news-trending-topics
      description: Microsoft Azure The News Trending Topics Api Lets You Search On Bing And Get Back A List Of Trending News
        Topics That Are Currently Trending On Bing This Section Provides Technical Details About The Query Parameters And
        Headers That You Use
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: news-search-client-newstrendingtopics.microsoftazurenewstrending
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        User-Agent: tools.User-Agent
        X-MSEdge-ClientID: tools.X-MSEdge-ClientID
        X-MSEdge-ClientIP: tools.X-MSEdge-ClientIP
        X-Search-Location: tools.X-Search-Location
        cc: tools.cc
        count: tools.count
        mkt: tools.mkt
        offset: tools.offset
        safeSearch: tools.safeSearch
        setLang: tools.setLang
        since: tools.since
        sortBy: tools.sortBy
        textDecorations: tools.textDecorations
        textFormat: tools.textFormat
      outputParameters:
      - type: object
        mapping: $.