eBay Buy Marketing API — Merchandised_product

naftiko: 1.0.0-alpha2
info:
  label: eBay Buy Marketing API — Merchandised_product
  description: 'eBay Buy Marketing API — Merchandised_product. 1 operations. Lead operation: Merchandised_product. Self-contained
    Naftiko capability covering one Ebay business surface.'
  tags:
  - Ebay
  - Merchandised_product
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: market-merchandised-product
    baseUri: https://api.ebay.com{basePath}
    description: eBay Buy Marketing API — Merchandised_product business capability. Self-contained, no shared references.
    resources:
    - name: merchandised_product
      path: /merchandised_product
      operations:
      - name: getmerchandisedproducts
        method: GET
        description: This method returns an array of products based on the category and metric specified. This includes details
          of the product, such as the eBay product ID (EPID), title, and user reviews and ratings for the product. You can
          use the <code>epid</
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: aspect_filter
          in: query
          type: string
          description: 'This value specifies the aspect name/value pairs used to further refine product results. <br /><br
            /> For example: <br />&nbsp;&nbsp;&nbsp;<code>/buy/marketing/'
        - name: category_id
          in: query
          type: string
          description: This query parameter limits the products returned to a specific eBay category.  <br /> <br />The list
            of eBay category IDs is not published and category IDs are
          required: true
        - name: limit
          in: query
          type: string
          description: This value specifies the maximum number of products to return in a result set. <br /> <br /><span class="tablenote">
            <b>Note:</b> Maximum value means the method
        - name: metric_name
          in: query
          type: string
          description: This value filters the result set by the specified metric. Only products in this metric are returned.<br><br><span
            class="tablenote"><b>Note:</b> Currently, the
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: market-merchandised-product-rest
    port: 8080
    description: REST adapter for eBay Buy Marketing API — Merchandised_product. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/merchandised-product
      name: merchandised-product
      description: REST surface for merchandised_product.
      operations:
      - method: GET
        name: getmerchandisedproducts
        description: This method returns an array of products based on the category and metric specified. This includes details
          of the product, such as the eBay product ID (EPID), title, and user reviews and ratings for the product. You can
          use the <code>epid</
        call: market-merchandised-product.getmerchandisedproducts
        with:
          aspect_filter: rest.aspect_filter
          category_id: rest.category_id
          limit: rest.limit
          metric_name: rest.metric_name
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: market-merchandised-product-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Buy Marketing API — Merchandised_product. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: this-method-returns-array-products
      description: This method returns an array of products based on the category and metric specified. This includes details
        of the product, such as the eBay product ID (EPID), title, and user reviews and ratings for the product. You can use
        the <code>epid</
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: market-merchandised-product.getmerchandisedproducts
      with:
        aspect_filter: tools.aspect_filter
        category_id: tools.category_id
        limit: tools.limit
        metric_name: tools.metric_name
      outputParameters:
      - type: object
        mapping: $.