eBay Marketplace API is one of 64 APIs that eBay publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Marketplace. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, release notes, and an AsyncAPI specification.
This API exposes
7 operations
across 7 paths,
and defines 26 schemas.
It is described by OpenAPI 3.0.0, at version v1.9.2.
Requests are made against a single base URL, https://api.ebay.com{basePath}.
7 operations7 paths26 schemas7 GET
Metadata
The identity and technical contract details declared by the specification.
eBay Marketplace API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (api_auth) using the authorizationCode flow, exposing 2 scopes.
api_auth — The security definitions for this API. Please check individual operations for applicable scopes.
Paths & Operations 7
Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.
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…
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 param…
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, stat…
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 s…
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 c…
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…
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…
getReturnPolicies3 params→ 200204400404500
Schemas 26
The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are Error (9 properties), ItemConditionDescriptorConstraint (6 properties), ReturnPolicyDetails (6 properties), ItemConditionDescriptorValue (5 properties). Each schema is shown below with its type and property counts.
ItemConditionPolicyResponse
object
2 properties
NegotiatedPricePolicy
object
5 properties
AutomotivePartsCompatibilityPolicy
object
5 properties
AutomotivePartsCompatibilityPolicyResponse
object
2 properties
ExtendedProducerResponsibilityPolicyResponse
object
A type that defines the response fields for the getExtendedProducerResponsibilityPolicies method.
2 properties
ItemCondition
object
Note: In all eBay marketplaces, Condition ID 2000 now maps to an item condition of 'Certified Refurbished', and not 'Manufacturer Refurbished'. To list an item…
5 properties
ItemConditionDescriptorConstraint
object
This type specifies the constraints on a condition descriptor, such as the maximum length, default condition descriptor value ID, cardinality, mode, usage, and…
6 properties
ItemConditionPolicy
object
4 properties
HazardStatement
object
A type that describes hazard statements for hazardous materials labels
2 properties
ListingStructurePolicyResponse
object
2 properties
Error
object
A container that defines the elements of error and warning messages.
9 properties
ReturnPolicyResponse
object
2 properties
SignalWord
object
A type that describes signal words for hazardous materials labels.
2 properties
ItemConditionDescriptorValueConstraint
object
This type shows the constraints on a condition descriptor value, such as any associated condition descriptor ID and condition descriptor value IDs required for…
2 properties
ListingStructurePolicy
object
3 properties
Pictogram
object
A type that describes pictograms for hazardous materials labels.
3 properties
ItemConditionDescriptor
object
This type is used to display the possible condition descriptors and condition values applicable for a specified category. It also returns usage requirements, m…
5 properties
HazardousMaterialDetailsResponse
object
A type that defines the response fields for the getHazardousMaterialsLabels method.
3 properties
ItemConditionDescriptorValue
object
This type displays the possible values for the corresponding condition descriptor, along with help text and constraint information.
5 properties
ReturnPolicyDetails
object
This container defines the category policies that relate to domestic and international return policies (the return shipping is made via a domestic or an intern…
6 properties
ReturnPolicy
object
5 properties
ErrorParameter
object
Container for a error parameter.
2 properties
ExtendedProducerResponsibility
object
A type that defines the attributes of an Extended Producer Responsibility policy.
3 properties
NegotiatedPricePolicyResponse
object
2 properties
TimeDuration
object
A complex type that specifies a period of time using a specified time-measurement unit.
2 properties
ExtendedProducerResponsibilityPolicy
object
A type that defines the Extended Producer Responsibility policy.
3 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
