# Catalog API API

> Catalog API API on Apizie: 2 endpoints (This method retrieves details of the catalog product identified by the eBay product identifier (ePID)…, This method searches for and retrieves summaries of one or more products in the eBay catalog that match the…) 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://zieapi.vercel.app/v1/ecommerce:ebay-commerce-catalog/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-commerce-catalog`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://zieapi.vercel.app/api/ecommerce/ebay-commerce-catalog
- OpenAPI: https://zieapi.vercel.app/api/ecommerce/ebay-commerce-catalog/openapi.json

The Catalog API allows users to search for and locate an eBay catalog product that is a direct match for the product that they wish to sell. Listing against an eBay catalog product helps insure that all listings (based…

## Endpoints

### This method retrieves details of the catalog product identified by the eBay product identifier (ePID)…
`GET https://zieapi.vercel.app/v1/ecommerce:ebay-commerce-catalog/get-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | no | This method also uses the X-EBAY-C-MARKETPLACE-ID header to identify the seller's eBay marketplace. It is required for all marketplaces… |
| epid | string | yes | The ePID of the product being requested. This value can be discovered by issuing the search method and examining the value of the… |

### This method searches for and retrieves summaries of one or more products in the eBay catalog that match the…
`GET https://zieapi.vercel.app/v1/ecommerce:ebay-commerce-catalog/search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | no | This method also uses the X-EBAY-C-MARKETPLACE-ID header to identify the seller's eBay marketplace. It is required for all marketplaces… |
| aspect_filter | string | no | An eBay category and one or more aspects of that category, with the values that can be used to narrow down the collection of products… |
| category_ids | string | no | Important: Currently, only the first category_id value is accepted. One or more comma-separated category identifiers for narrowing down… |
| fieldgroups | string | no | The type of information to return in the response. Important: This parameter may not produce valid results if you also provide more than… |
| gtin | string | no | A string consisting of one or more comma-separated Global Trade Item Numbers (GTINs) that identify products to search for. Currently the… |
| limit | string | no | The number of product summaries to return. This is the result set , a subset of the full collection of products that match the search or… |
| mpn | string | no | A string consisting of one or more comma-separated Manufacturer Part Numbers (MPNs) that identify products to search for. This method will… |
| offset | string | no | This parameter is reserved for internal or future use. |
| q | string | no | A string consisting of one or more keywords to use to search for products in the eBay catalog. Note: This method searches the following… |

## Example
```
curl "https://zieapi.vercel.app/v1/ecommerce:ebay-commerce-catalog/get-product" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Catalog API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ecommerce:ebay-commerce-catalog/get-product with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Catalog API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-commerce-catalog.

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