# eBay Product API

> Get an eBay product by product ID: title, price, condition, quantity sold, item specifics, media, shipping, returns and seller details.

Source: https://www.sandbase.ai/apis/ebay/product
API reference: https://www.sandbase.ai/apis/ebay/product/docs

## Facts

- Provider: eBay
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/ebay/product`
- Price: $0.01 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, ebay, ecommerce, product data
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/ebay/product` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `product_id` | string \| number \| boolean | yes |  |
| `lang` | string \| number \| boolean | no |  |
| `locale` | string \| number \| boolean | no |  |
| `ebay_domain` | string \| number \| boolean | no |  |
| `json_restrictor` | string \| number \| boolean | no |  |
| `shipping_country` | string \| number \| boolean | no |  |

## FAQ

### How do I use the eBay Product API?

Send a POST request to https://api.sandbase.ai/v1/api/ebay/product with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the eBay Product API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the eBay Product API accept?

Required: product_id (string | number | boolean). Optional: lang (string | number | boolean), locale (string | number | boolean), ebay_domain (string | number | boolean), json_restrictor (string | number | boolean) and shipping_country (string | number | boolean). The Parameters table and the Playground on this page list every field.

### What does the eBay Product API return?

A JSON result. This endpoint runs asynchronously, so the response tells you how to fetch the finished result.

### Do I need a eBay developer account or API key?

No. eBay Product runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for eBay API access separately.

## README

### eBay Product

Get an eBay product by product ID: title, price, condition, quantity sold, item specifics, media, shipping, returns and seller details.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "ebay/product", "product_id": "326405504746"}'
```

This API runs asynchronously. `/v1/run` returns a task `id` with status `pending`; poll `GET https://api.sandbase.ai/v1/run/{id}` until `status` is `completed` and read the result from `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `product_id` | string/number/boolean | Yes | An ID of the product to get results for. Normally, it can be found in product link from search results: `https://www.ebay.com/itm/{product_id}` |
| `ebay_domain` | string/number/boolean | No | The eBay domain to use. It defaults to `ebay.com`. Head to the eBay domains for a full list of supported domains. |
| `json_restrictor` | string/number/boolean | No | The fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |
| `lang` | string/number/boolean | No | The language to use for the search. Normally, it defaults to `en-US`, but some locales use localized interface (Japan, Argentina etc.) so override might be helpful. This parameter available only for `… |
| `locale` | string/number/boolean | No | From where you want the search to originate from. Head to the eBay locales for a full list of supported locales. |
| `shipping_country` | string/number/boolean | No | The shipping country to use for shipping data calculation. Head to the eBay shipping countries for a full list of supported countries. |

#### Pricing

Flat price per call. Failed calls are not charged.