APIs.io Engineering Platform Video Search Client — VideoDetailSearch

naftiko: 1.0.0-alpha2
info:
  label: APIs.io Engineering Platform Video Search Client — VideoDetailSearch
  description: 'APIs.io Engineering Platform Video Search Client — VideoDetailSearch. 1 operations. Lead operation: APIs.io
    Engineering Platform The Video Detail Search API lets you search on Bing and get back insights about a video, such as
    related videos. This section provides technical details about the query parameters and headers that you use to request
    insights of videos and the JSON response objects that c'
  tags:
  - Engineering Platform
  - VideoDetailSearch
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ENGINEERING_PLATFORM_API_KEY: ENGINEERING_PLATFORM_API_KEY
capability:
  consumes:
  - type: http
    namespace: microsoft-cognitive-video-search-videodetailsearch
    baseUri: https://api.cognitive.microsoft.com/bing/v7.0
    description: APIs.io Engineering Platform Video Search Client — VideoDetailSearch business capability. Self-contained,
      no shared references.
    resources:
    - name: videos-details
      path: /videos/details
      operations:
      - name: videosdetails
        method: GET
        description: APIs.io Engineering Platform The Video Detail Search API lets you search on Bing and get back insights
          about a video, such as related videos. This section provides technical details about the query parameters and headers
          that you use to req
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-BingApis-SDK
          in: header
          type: string
          description: Activate swagger compliance
          required: true
        - 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: id
          in: query
          type: string
          description: An ID that uniquely identifies a video. The [Video](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-video-api-v7-reference#video)
            object's vide
        - name: modules
          in: query
          type: array
          description: 'A comma-delimited list of insights to request. The following are the possible case-insensitive values.
            All: Return all available insights. RelatedVideos: Return'
        - 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: q
          in: query
          type: string
          description: The user's search query string. The query string cannot be empty. The query string may contain [Bing
            Advanced Operators](http://msdn.microsoft.com/library/ff795
          required: true
        - name: resolution
          in: query
          type: string
          description: 'Filter videos by the following resolutions: SD480p: Return videos with a 480p or higher resolution.
            HD720p: Return videos with a 720p or higher resolution. HD10'
        - name: safeSearch
          in: query
          type: string
          description: 'Filter videos for adult content. The following are the possible filter values. Off: If the request
            is through the Video Search API, the response includes adult '
        - 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: 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
    authentication:
      type: apikey
      key: Ocp-Apim-Subscription-Key
      value: '{{env.ENGINEERING_PLATFORM_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: microsoft-cognitive-video-search-videodetailsearch-rest
    port: 8080
    description: REST adapter for APIs.io Engineering Platform Video Search Client — VideoDetailSearch. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/videos/details
      name: videos-details
      description: REST surface for videos-details.
      operations:
      - method: GET
        name: videosdetails
        description: APIs.io Engineering Platform The Video Detail Search API lets you search on Bing and get back insights
          about a video, such as related videos. This section provides technical details about the query parameters and headers
          that you use to req
        call: microsoft-cognitive-video-search-videodetailsearch.videosdetails
        with:
          X-BingApis-SDK: rest.X-BingApis-SDK
          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
          id: rest.id
          modules: rest.modules
          mkt: rest.mkt
          q: rest.q
          resolution: rest.resolution
          safeSearch: rest.safeSearch
          setLang: rest.setLang
          textDecorations: rest.textDecorations
          textFormat: rest.textFormat
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: microsoft-cognitive-video-search-videodetailsearch-mcp
    port: 9090
    transport: http
    description: MCP adapter for APIs.io Engineering Platform Video Search Client — VideoDetailSearch. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: apis-io-engineering-platform-video-detail
      description: APIs.io Engineering Platform The Video Detail Search API lets you search on Bing and get back insights
        about a video, such as related videos. This section provides technical details about the query parameters and headers
        that you use to req
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-cognitive-video-search-videodetailsearch.videosdetails
      with:
        X-BingApis-SDK: tools.X-BingApis-SDK
        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
        id: tools.id
        modules: tools.modules
        mkt: tools.mkt
        q: tools.q
        resolution: tools.resolution
        safeSearch: tools.safeSearch
        setLang: tools.setLang
        textDecorations: tools.textDecorations
        textFormat: tools.textFormat
      outputParameters:
      - type: object
        mapping: $.