- eBay’s Modernized REST and GraphQL APIs are now Generally Available. Explore the next generation of eBay APIs with migration guides , AI-powered development tools , SDKs , and easy-to-use API Explorers — all designed to help you build faster and migrate with confidence. Get Started with APIs.
- eBay Partner Program 2027: The 2027 program criteria have been announced, and applications are now open. Review the updated criteria and apply here.
Search Documentation
Inventory Discovery and Refresh
config
public_key
subscription
item
item_group
item_snapshot
item_priority
Marketing and Discounts
merchandised_product
merchandised_product
most_watched_items
similar_items
Marketplace Metadata
charity_org
product
product_summary
Order Management
Queries
Queries
Account Management
Watchlist
Buying Activity
User Notes
User Authentication
Communication
config
public_key
subscription
awaiting_feedback
feedback
feedback_rating_summary
respond_to_feedback
Other APIs
language
vero_reason_code
vero_report
vero_report_items
vero_reason_code
report_vero_violations
vero_report
vero_report_items
Watch List
The Watch List API provides read access to a user's watchlists for both the default watchlist and any custom lists. Use this API to enable saved and favorites experiences. You can retrieve the default list with userWatchList and fetch one, multiple, or all custom lists with userCustomLists. Both queries return structured results and surface validation or retrieval errors (for example, invalid pagination values or partial/all failures for custom lists). To modify watchlists, use mutations such as addToWatchList to add one or more items by itemID, removeFromWatchList to remove specific items, and removeAllFromWatchList to clear a list. These mutations provide detailed success or failure feedback.
GraphQL
Endpoints
- MutationaddToWatchList
- MutationremoveFromWatchList
- MutationremoveAllFromWatchList
- QueryuserWatchList
- QueryuserCustomLists