Getautomotivepartscompatibilitypolicies — This method returns the eBay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace.
By default, this method returns all categories that support parts compatibility. You
Getextendedproducerresponsibilitypolicies — This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace.
The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay
Gethazardousmaterialslabels — 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
Getitemconditionpolicies — 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
Getlistingstructurepolicies — 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.
Getnegotiatedpricepolicies — This method returns the eBay policies that define the supported negotiated price features (like "best offer") for the categories of a specific marketplace.
By default, this method returns the entire category tree for the specified
Getreturnpolicies — 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
This method returns the eBay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace.
By default, this method returns all categories that support parts compatibility. You
read-onlyidempotent
this-method-returns-extended-producer
This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace.
The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay
read-onlyidempotent
this-method-returns-hazardous-materials
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
read-onlyidempotent
this-method-returns-item-condition
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
read-onlyidempotent
this-method-returns-ebay-policies-2
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.
B
read-onlyidempotent
this-method-returns-ebay-policies-3
This method returns the eBay policies that define the supported negotiated price features (like "best offer") for the categories of a specific marketplace.
By default, this method returns the entire category tree for the specified
read-onlyidempotent
this-method-returns-ebay-policies-4
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
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: $.