This doc page has moved! You should be automatically redirected to the new location. If you are not redirected automatically, follow this link to the new page.

You are here: Sell APIs > The Metadata API

The Metadata API

The Metadata API lets you retrieve information that helps you list items in different eBay marketplaces.

Technical overview

The Metadata API contains methods in the following resources:

  • country
  • marketplace

The methods in these resources let you retrieve configuration details that pertain to the different eBay marketplaces, as well as get information about the areas into which you sell.

Business use cases

The Metadata API supports the use cases outlined below.

Retrieve the listing policies for an eBay marketplace and category ID

Each eBay marketplace has policies that govern how you can list items in the different categories of the marketplace. The marketplace resource contains several GET methods that let you retrieve the following listing policies for specific marketplace categories:

  • Policies that define how to list automotive parts compatibility items
  • Policies that define how to specify the condition of the items you list
  • Policies that define which categories support listings with item variations
  • Policies that define which negotiated price (best offer) features are available for a specific category
  • Policies that define the categories that require all listing have item return policies

Important! The listing policies are specific to an eBay marketplace and category ID. Be sure to use the policies that match the categories into which you list items.

Retrieve sales tax jurisdictions

Canada (CA), India (IN), and the United States (US) all define different sales tax jurisdictions for the different regions in their countries. Seller can ease the process of calculating the final value of the items they sell by setting up tax tables for the tax jurisdictions where they must charge sales tax.

Use getSalesTaxJurisdictions to retrieve details on a county's different sales tax jurisdictions, then use the sales_tax resource of the Accounts API to set up and manage your sales tax tables.

API restrictions

The getSalesTaxJurisdictions method returns data for only the countries that designate different sales tax jurisdictions. These countries are currently limited to Canada (CA), India (IN), and the United States (US).

The methods in the marketplace resource return data for only the eBay marketplaces in the following list:

Marketplace

Identifier

eBay Australia (ebay.com/au)

EBAY_AU

eBay Austria (ebay.at)

EBAY_AT

eBay Canada (English) (ebay.ca)

EBAY_CA

eBay France (ebay.fr)

EBAY_FR

eBay Germany (ebay.de)

EBAY_DE

eBay Hong Kong (ebay.com.hk)

EBAY_HK

eBay India (ebay.in)

EBAY_IN

eBay Ireland (ebay.ie)

EBAY_IE

eBay Italy (ebay.it)

EBAY_IT

eBay Malaysia (ebay.com/my)

EBAY_MY

eBay Motors US (ebay.com/motors)

EBAY_MOTORS_US

eBay Netherlands (ebay.nl)

EBAY_NL

eBay Philippines (ebay.ph)

EBAY_PH

eBay Poland (ebay.pl)

EBAY_PL

eBay Russia (ebay.com/sch/Russia)

EBAY_RU

eBay Singapore (ebay.com/sg)

EBAY_SG

eBay Spain (ebay.es)

EBAY_ES

eBay Switzerland (ebay.ch)

EBAY_CH

eBay UK (ebay.co.uk)

EBAY_GB

eBay US (ebay.com)

EBAY_US