# Buy Marketing API API

> Buy Marketing API API on Apizie: 1 endpoint (This method returns an array of products based on the category and metric specified. This includes details…) 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-buy-marketing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

The Marketing API retrieves eBay products based on a metric, such as Best Selling, as well as products that were also bought and also viewed.

## Endpoints

### This method returns an array of products based on the category and metric specified. This includes details…
`GET https://zieapi.vercel.app/v1/ecommerce:ebay-buy-marketing/get-merchandised-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| aspect_filter | string | no | The aspect name/value pairs used to further refine product results. For example:    … |
| category_id | string | yes | This query parameter limits the products returned to a specific eBay category. The list of eBay category IDs is not published and category… |
| limit | string | no | This value specifies the maximum number of products to return in a result set. Note: Maximum value means the method will return up to that… |
| metric_name | string | yes | This value filters the result set by the specified metric. Only products in this metric are returned. Currently, the only metric supported… |

## Example
```
curl "https://zieapi.vercel.app/v1/ecommerce:ebay-buy-marketing/get-merchandised-products" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

### Can AI agents use the Buy Marketing 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-buy-marketing.

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