The Browse API has the following resources:
- item_summary: Lets shoppers search for specific items by keyword, GTIN, category, charity, product, image
(Experimental Method), or item aspects and refine the results by using filters, such as aspects, compatibility, and fields values, or UI parameters.
- item:
- Lets you retrieve the details of a specific item or all the items in an item group, which is an item with variations such as color and size and check if a product is compatible with the specified item, such as if a specific car is compatible with a specific part.
- Provides a bridge between the eBay legacy APIs, such as Finding, and the RESTful APIs, which use different formats for the item IDs.
The item_summary, search_by_image, and item resource calls require an Application access token.
item_summary
Method Name | HTTP Method | Path | Summary | Samples |
---|---|---|---|---|
search | GET | /item_summary/search | Retrieves one or more eBay listings based on an advanced set of inclusive and exclusive search filters. | View search - /item_summary/search |
searchByImage | POST | /item_summary/search_by_image | Retrieves one or more eBay listings based on a supplied Base64 image string and an advanced set of inclusive and exclusive search filters. | View searchByImage - /item_summary/search_by_image |
item
Method Name | HTTP Method | Path | Summary | Samples |
---|---|---|---|---|
getItem | GET | /item/{item_id} | Retrieves an eBay listing by eBay RESTful ID, with a fieldgroups query parameter that controls the detail level of the response. | View getItem - /item/{item_id} |
getItemByLegacyId | GET | /item/get_item_by_legacy_id | Retrieves an eBay listing by traditional item ID value, by traditional variation ID value, or by seller-defined SKU, with a fieldgroups query parameter that controls the detail level of the response. | View getItemByLegacyId - /item/get_item_by_legacy_id |
getItems | GET | /item/ | Retrieves an abbreviated set of details on one or more eBay listings, identified with eBay RESTful item IDs or item group IDs. | View getItems - /item/ |
getItemsByItemGroup | GET | /item/get_items_by_item_group | Retrieves the details for individual items (variations) in the specified item group. | View getItemsByItemGroup - /item/get_items_by_item_group |
checkCompatibility | POST | /item/{item_id}/check_compatibility | Checks if the specified product is compatible with the specified item. For example: If a specific car is compatible with a specific part. | View checkCompatibility - /item/{item_id}/check_compatibility |