Skip to main content

  • New Feature: The Inventory Mapping API helps you turn your existing product data into high-quality listings with AI-powered recommendations. Learn more here.
  • Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.
  • Action required: From early May, API users must include standardized condition details when creating or updating listings. Update your integration to stay compliant. Learn more here.

This API provides stores-related resources for third-party developers. These resources let you retrieve basic store information such as store name, description, store url, return store category hierarchy, add/rename/move/delete a single user's eBay store category, and retrieve the processing status of these tasks.

The stores resource methods require an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application)

store

Method NameHTTP MethodPathSummarySamples
addStoreCategoryPOST/store/categoriesAdds a single new category to a user's eBay store.View addStoreCategory - /store/categories
deleteStoreCategoryDELETE/store/categories/{category_id}Deletes one category of a user's eBay store.View deleteStoreCategory - /store/categories/{category_id}
getStoreGET/storeRetrieves information such as store name, store URL, and description for an eBay store.View getStore - /store
getStoreCategoriesGET/store/categoriesRetrieves eBay Store Category hierarchy.View getStoreCategories - /store/categories
getStoreTaskGET/store/tasks/{task_id}Retrieves the current status of a recent store operation.View getStoreTask - /store/tasks/{task_id}
getStoreTasksGET/store/tasksRetrieves all store tasks.View getStoreTasks - /store/tasks
moveStoreCategoryPOST/store/categories/move_categoryMove single category of a user's eBay store.View moveStoreCategory - /store/categories/move_category
renameStoreCategoryPUT/store/categories/{category_id}Renames a single category of a user's eBay store.View renameStoreCategory - /store/categories/{category_id}