# eBay Browse API

**Provider:** eBay
**Category:** ecommerce
**Base URL:** `https://api.ebay.com/buy/browse/v1`
**Auth:** oauth2 — `Authorization: Bearer v^1.1#...`
**Rate Limit:** 5,000 calls/day (default)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.ebay.com/api-docs/buy/browse/overview.html

## Description

The eBay Browse API gives access to eBay's massive marketplace of 1.5+ billion active listings. Search items using keywords, category IDs, and faceted filters (price, condition, seller, location). Retrieve detailed item data including images, seller ratings, shipping options, return policies, and item specifics. Ideal for price comparison engines, deal aggregators, and shopping tools.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.ebay.com/buy/browse/v1/item_summary/search` | Search items with keyword, filters, and facets |
| GET | `https://api.ebay.com/buy/browse/v1/item/{itemId}` | Get full item details including images and seller info |
| GET | `https://api.ebay.com/buy/browse/v1/item/get_items_by_item_group` | Get all variations of a multi-variant item |
| GET | `https://api.ebay.com/buy/browse/v1/item_summary/search?category_ids={id}` | Browse items in a specific eBay category |

## Authentication

eBay uses OAuth 2.0 Client Credentials flow for application-level access. Request an access token from the eBay IAM endpoint, then pass it as a Bearer token.

```
Authorization: Bearer v^1.1#...
```

## Sample Request

```bash
# First get an OAuth token, then:
curl "https://api.ebay.com/buy/browse/v1/item_summary/search?q=vintage+camera&limit=3&filter=condition%3AUSED" \
  -H "Authorization: Bearer $EBAY_ACCESS_TOKEN" \
  -H "X-EBAY-C-MARKETPLACE-ID: EBAY_US"
```

## Sample Response

```json
{
  "total": 48231,
  "itemSummaries": [{
    "itemId": "v1|382847362890|0",
    "title": "Vintage Canon AE-1 35mm Film Camera",
    "price": {"value": "149.99", "currency": "USD"},
    "condition": "Used",
    "seller": {"username": "vintagecams_sf", "feedbackScore": 4219},
    "shippingOptions": [{"shippingCost": {"value": "0.00"}}]
  }]
}
```

## Pricing Details

API access is free for approved developers. eBay charges sellers insertion and final value fees. Higher API call limits may be requested for high-volume apps.

---

*Source: [API Map](https://apimap.dev/apis/ebay/) — CC BY 4.0*