naftiko: 1.0.0-alpha2
info:
  label: eBay Metadata API — Marketplace
  description: 'eBay Metadata API — Marketplace. 7 operations. Lead operation: Marketplace. Self-contained Naftiko capability
    covering one Ebay business surface.'
  tags:
  - Ebay
  - Marketplace
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: metadata-marketplace
    baseUri: https://api.ebay.com{basePath}
    description: eBay Metadata API — Marketplace business capability. Self-contained, no shared references.
    resources:
    - name: marketplace-marketplace_id-get_automotive_parts_compatibility_policies
      path: /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies
      operations:
      - name: getautomotivepartscompatibilitypolicies
        method: GET
        description: This method returns the eBay policies that define how to list automotive parts compatibility items in
          the categories of the specified marketplace.  <br><br>By default, this method returns all categories that support
          parts compatibility. You
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: This query parameter limits the response by returning policy information for only the selected sections
            of the category tree. Supply <b>categoryId</b> values fo
        - name: marketplace_id
          in: path
          type: string
          description: 'This path parameter specifies the eBay marketplace for which policy information is retrieved.  <br><br><span
            class="tablenote"><b>Note: </b>Only the following e'
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    - name: marketplace-marketplace_id-get_extended_producer_responsibility_policies
      path: /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies
      operations:
      - name: getextendedproducerresponsibilitypolicies
        method: GET
        description: 'This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories
          in an eBay marketplace.<br><br>The identifier of the eBay marketplace is passed in as a path parameter, and unless
          one or more eBay '
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: A query parameter that can be used to limit the response by returning policy information for only the
            selected sections of the category tree. Supply <b>category
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which policy information shall be retrieved.<br><br>See
            <a href="/api-docs/static/rest-request-components
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    - name: marketplace-marketplace_id-get_hazardous_materials_labels
      path: /marketplace/{marketplace_id}/get_hazardous_materials_labels
      operations:
      - name: gethazardousmaterialslabels
        method: GET
        description: This method returns hazardous materials label information for the specified eBay marketplace. The information
          includes IDs, descriptions, and URLs (as applicable) for the available signal words, statements, and pictograms.
          The returned stat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which hazardous materials label information
            shall be retrieved.<br><br>See <a href="/api-docs/static/rest
          required: true
    - name: marketplace-marketplace_id-get_item_condition_policies
      path: /marketplace/{marketplace_id}/get_item_condition_policies
      operations:
      - name: getitemconditionpolicies
        method: GET
        description: 'This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace.
          This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean
          to indicate if an '
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: This query parameter limits the response by returning policy information for only the selected sections
            of the category tree. Supply <b>categoryId</b> values fo
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which policy information is retrieved.<br><br>See
            <a href="/api-docs/static/rest-request-components.html#
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    - name: marketplace-marketplace_id-get_listing_structure_policies
      path: /marketplace/{marketplace_id}/get_listing_structure_policies
      operations:
      - name: getlistingstructurepolicies
        method: GET
        description: This method returns the eBay policies that define the allowed listing structures for the categories of
          a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with
          variations.  <br><br>B
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: This query parameter limits the response by returning policy information for only the selected sections
            of the category tree. Supply <b>categoryId</b> values fo
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which policy information is retrieved. <br><br>See
            <a href="/api-docs/static/rest-request-components.html
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    - name: marketplace-marketplace_id-get_negotiated_price_policies
      path: /marketplace/{marketplace_id}/get_negotiated_price_policies
      operations:
      - name: getnegotiatedpricepolicies
        method: GET
        description: 'This method returns the eBay policies that define the supported negotiated price features (like "best
          offer") for the categories of a specific marketplace.  <br><br>By default, this method returns the entire category
          tree for the specified '
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: This query parameter limits the response by returning policy information for only the selected sections
            of the category tree. Supply <b>categoryId</b> values fo
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which policy information is retrieved.<br><br>See
            <a href="/api-docs/static/rest-request-components.html#
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    - name: marketplace-marketplace_id-get_return_policies
      path: /marketplace/{marketplace_id}/get_return_policies
      operations:
      - name: getreturnpolicies
        method: GET
        description: This method returns the eBay policies that define whether or not you must include a return policy for
          the items you list in the categories of a specific marketplace, plus the guidelines for creating domestic and international
          return policie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: This query parameter limits the response by returning policy information for only the selected sections
            of the category tree. Supply <b>categoryId</b> values fo
        - name: marketplace_id
          in: path
          type: string
          description: This path parameter specifies the eBay marketplace for which policy information is retrieved.<br><br>See
            <a href="/api-docs/static/rest-request-components.html#
          required: true
        - name: Accept-Encoding
          in: header
          type: string
          description: 'This header indicates the compression-encoding algorithms the client accepts for the response. This
            value should be set to <code>gzip</code>. <br><br> For more '
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: metadata-marketplace-rest
    port: 8080
    description: REST adapter for eBay Metadata API — Marketplace. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/marketplace/{marketplace-id}/get-automotive-parts-compatibility-policies
      name: marketplace-marketplace-id-get-automotive-parts-compatibility-policies
      description: REST surface for marketplace-marketplace_id-get_automotive_parts_compatibility_policies.
      operations:
      - method: GET
        name: getautomotivepartscompatibilitypolicies
        description: This method returns the eBay policies that define how to list automotive parts compatibility items in
          the categories of the specified marketplace.  <br><br>By default, this method returns all categories that support
          parts compatibility. You
        call: metadata-marketplace.getautomotivepartscompatibilitypolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-extended-producer-responsibility-policies
      name: marketplace-marketplace-id-get-extended-producer-responsibility-policies
      description: REST surface for marketplace-marketplace_id-get_extended_producer_responsibility_policies.
      operations:
      - method: GET
        name: getextendedproducerresponsibilitypolicies
        description: 'This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories
          in an eBay marketplace.<br><br>The identifier of the eBay marketplace is passed in as a path parameter, and unless
          one or more eBay '
        call: metadata-marketplace.getextendedproducerresponsibilitypolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-hazardous-materials-labels
      name: marketplace-marketplace-id-get-hazardous-materials-labels
      description: REST surface for marketplace-marketplace_id-get_hazardous_materials_labels.
      operations:
      - method: GET
        name: gethazardousmaterialslabels
        description: This method returns hazardous materials label information for the specified eBay marketplace. The information
          includes IDs, descriptions, and URLs (as applicable) for the available signal words, statements, and pictograms.
          The returned stat
        call: metadata-marketplace.gethazardousmaterialslabels
        with:
          marketplace_id: rest.marketplace_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-item-condition-policies
      name: marketplace-marketplace-id-get-item-condition-policies
      description: REST surface for marketplace-marketplace_id-get_item_condition_policies.
      operations:
      - method: GET
        name: getitemconditionpolicies
        description: 'This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace.
          This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean
          to indicate if an '
        call: metadata-marketplace.getitemconditionpolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-listing-structure-policies
      name: marketplace-marketplace-id-get-listing-structure-policies
      description: REST surface for marketplace-marketplace_id-get_listing_structure_policies.
      operations:
      - method: GET
        name: getlistingstructurepolicies
        description: This method returns the eBay policies that define the allowed listing structures for the categories of
          a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with
          variations.  <br><br>B
        call: metadata-marketplace.getlistingstructurepolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-negotiated-price-policies
      name: marketplace-marketplace-id-get-negotiated-price-policies
      description: REST surface for marketplace-marketplace_id-get_negotiated_price_policies.
      operations:
      - method: GET
        name: getnegotiatedpricepolicies
        description: 'This method returns the eBay policies that define the supported negotiated price features (like "best
          offer") for the categories of a specific marketplace.  <br><br>By default, this method returns the entire category
          tree for the specified '
        call: metadata-marketplace.getnegotiatedpricepolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/marketplace/{marketplace-id}/get-return-policies
      name: marketplace-marketplace-id-get-return-policies
      description: REST surface for marketplace-marketplace_id-get_return_policies.
      operations:
      - method: GET
        name: getreturnpolicies
        description: This method returns the eBay policies that define whether or not you must include a return policy for
          the items you list in the categories of a specific marketplace, plus the guidelines for creating domestic and international
          return policie
        call: metadata-marketplace.getreturnpolicies
        with:
          filter: rest.filter
          marketplace_id: rest.marketplace_id
          Accept-Encoding: rest.Accept-Encoding
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: metadata-marketplace-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Metadata API — Marketplace. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: this-method-returns-ebay-policies
      description: This method returns the eBay policies that define how to list automotive parts compatibility items in the
        categories of the specified marketplace.  <br><br>By default, this method returns all categories that support parts
        compatibility. You
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getautomotivepartscompatibilitypolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-extended-producer
      description: 'This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories
        in an eBay marketplace.<br><br>The identifier of the eBay marketplace is passed in as a path parameter, and unless
        one or more eBay '
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getextendedproducerresponsibilitypolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-hazardous-materials
      description: This method returns hazardous materials label information for the specified eBay marketplace. The information
        includes IDs, descriptions, and URLs (as applicable) for the available signal words, statements, and pictograms. The
        returned stat
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.gethazardousmaterialslabels
      with:
        marketplace_id: tools.marketplace_id
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-item-condition
      description: 'This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace.
        This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean to
        indicate if an '
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getitemconditionpolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-ebay-policies-2
      description: This method returns the eBay policies that define the allowed listing structures for the categories of
        a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with
        variations.  <br><br>B
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getlistingstructurepolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-ebay-policies-3
      description: 'This method returns the eBay policies that define the supported negotiated price features (like "best
        offer") for the categories of a specific marketplace.  <br><br>By default, this method returns the entire category
        tree for the specified '
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getnegotiatedpricepolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-returns-ebay-policies-4
      description: This method returns the eBay policies that define whether or not you must include a return policy for the
        items you list in the categories of a specific marketplace, plus the guidelines for creating domestic and international
        return policie
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: metadata-marketplace.getreturnpolicies
      with:
        filter: tools.filter
        marketplace_id: tools.marketplace_id
        Accept-Encoding: tools.Accept-Encoding
      outputParameters:
      - type: object
        mapping: $.