# Browse API API

> Browse API API on Apizie: 11 endpoints (This method retrieves the details of specific items that the buyer needs to make a purchasing decision.…, This method is a bridge between the eBay legacy APIs, such as Shopping, and Finding and the eBay Buy APIs.…, This method retrieves the details of the individual items in an item group. An item group is an item that…, This method retrieves the details of a specific item, such as description, price, category, all item…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:ebay-buy-browse/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-buy-browse`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://apizie.tech/api/ecommerce/ebay-buy-browse
- OpenAPI: https://apizie.tech/api/ecommerce/ebay-buy-browse/openapi.json

The Browse API has the following resources: item_summary: Lets shoppers search for specific items by keyword, GTIN, category, charity, product, or item aspects and refine the results by using filters, such as aspects,…

## Endpoints

### This method retrieves the details of specific items that the buyer needs to make a purchasing decision.…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| item_ids | string | no | A list of item IDs. Item IDs are the eBay RESTful identifier of items. RESTful Item ID Format: v1/#/# For example: v1/272394640372/0 or… |
| item_group_ids | string | no | A list of item group IDs. Item group IDs are the eBay RESTful identifier of item groups. RESTful Group Item ID Format: ############ For… |

### This method is a bridge between the eBay legacy APIs, such as Shopping, and Finding and the eBay Buy APIs.…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-item-by-legacy-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fieldgroups | string | no | This field lets you control what is returned in the response. If you do not set this field, the method returns all the details of the… |
| legacy_item_id | string | yes | Specifies either: The legacy item ID of an item that is not part of a group. The legacy item ID of a group, which is the ID of the… |
| legacy_variation_id | string | no | Specifies the legacy item ID of a specific item in an item group, such as the red shirt size L. Legacy ids are returned by APIs, such as… |
| legacy_variation_sku | string | no | Specifics the legacy SKU of the item. SKU are item ids created by the seller. Legacy SKUs are returned by eBay the Shopping API. The… |

### This method retrieves the details of the individual items in an item group. An item group is an item that…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-items-by-item-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| item_group_id | string | yes | Identifier of the item group to return. An item group is an item that has various aspect differences, such as color, size, storage… |

### This method retrieves the details of a specific item, such as description, price, category, all item…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fieldgroups | string | no | This parameter lets you control what is returned in the response. If you do not set this field, the method returns all the details of the… |
| item_id | string | yes | The eBay RESTful identifier of an item. This ID is returned by the Browse and Feed API methods. RESTful Item ID Format: v1/#/# For… |

### This method checks if a product is compatible with the specified item. You can use this method to check the…
`POST https://apizie.tech/v1/ecommerce:ebay-buy-browse/check-compatibility` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| item_id | string | yes | The eBay RESTful identifier of an item (such as a part you want to check). This ID is returned by the Browse and Feed API methods. RESTful… |
| X-EBAY-C-MARKETPLACE-ID | string | yes | The ID of the eBay marketplace you want to use. Note: This value is case sensitive. For example: &nbsp;&nbsp;X-EBAY-C-MARKETPLACE-ID =… |
| body | object | no | JSON request body |

### This method searches for eBay items by various query parameters and retrieves summaries of the items. You…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| aspect_filter | string | no | This field lets you filter by item aspects. The aspect name/value pairs and category, which is required, is used to limit the results to… |
| auto_correct | string | no | A query parameter that enables auto correction. Valid Values: KEYWORD |
| category_ids | string | no | The category ID is used to limit the results. This field can have one category ID or a comma separated list of IDs. For example:… |
| charity_ids | string | no | The charity ID is used to limit the results to only items associated with the specified charity. This field can have one charity ID or a… |
| compatibility_filter | string | no | This field specifies the attributes used to define a specific product. The service searches for items matching the keyword or matching the… |
| epid | string | no | The ePID is the eBay product identifier of a product from the eBay product catalog. This field limits the results to only items in the… |
| fieldgroups | string | no | This field is a comma separated list of values that lets you control what is returned in the response. The default is MATCHING_ITEMS,… |
| filter | string | no | This field supports multiple field filters that can be used to limit/customize the result set. For example:… |
| gtin | string | no | This field lets you search by the Global Trade Item Number of the item as defined by https://www.gtin.info. You can search only by UPC… |
| limit | string | no | The number of items, from the result set, returned in a single page. Default: 50 Maximum number of items per page (limit): 200 Maximum… |
| offset | string | no | Specifies the number of items to skip in the result set. This is used with the limit field to control the pagination of the output. If… |
| q | string | no | A string consisting of one or more keywords that are used to search for items on eBay. The keywords are handled as follows: If the… |
| sort | string | no | Specifies the order and the field name to use to sort the items. You can sort items by price (in ascending or descending order) or by… |

### This is an Experimental method. This method searches for eBay items based on a image and retrieves summaries…
`POST https://apizie.tech/v1/ecommerce:ebay-buy-browse/search-by-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| aspect_filter | string | no | This field lets you filter by item aspects. The aspect name/value pairs and category, which is required, is used to limit the results to… |
| category_ids | string | no | The category ID is used to limit the results. This field can have one category ID or a comma separated list of IDs. Note: Currently, you… |
| charity_ids | string | no | The charity ID is used to limit the results to only items associated with the specified charity. This field can have one charity ID or a… |
| fieldgroups | string | no | This field is a comma separated list of values that lets you control what is returned in the response. The default is MATCHING_ITEMS,… |
| filter | string | no | This field supports multiple field filters that can be used to limit/customize the result set. For example:… |
| limit | string | no | The number of items, from the result set, returned in a single page. Default: 50 Maximum number of items per page (limit): 200 Maximum… |
| offset | string | no | The number of items to skip in the result set. This is used with the limit field to control the pagination of the output. If offset is 0… |
| sort | string | no | Specifies the order and the field name to use to sort the items. You can sort items by price (in ascending or descending order) or by… |
| body | object | no | JSON request body |

### This is an experimental method. This method retrieves all the items in the eBay member's cart; items added…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-shopping-cart` (byok)

### This is an Experimental method. This method creates an eBay cart for the eBay member, if one does not exist,…
`POST https://apizie.tech/v1/ecommerce:ebay-buy-browse/add-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### This is an experimental method. This method removes a specific item from the eBay member's cart. You specify…
`POST https://apizie.tech/v1/ecommerce:ebay-buy-browse/remove-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### This is an experimental method. This method updates the quantity value of a specific item in the eBay…
`POST https://apizie.tech/v1/ecommerce:ebay-buy-browse/update-quantity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

## Example
```
curl "https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-items" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Browse API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:ebay-buy-browse/get-items with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Browse API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Browse API itself also needs your own key from ebay.com.

### Can AI agents use the Browse API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-buy-browse.

### What is the status of the Browse API API?
Needs your own provider key (bring your own key)
