eBay
Active listings plus sold prices and market stats.
/ebay/v1/search1 creditactive-listing search by `query` -> results[]{item_id,title,price{value,currency},condition,buying_format,shipping,location,image,url,sold_count?,catalog_rating?}. Filters: domain(com/co.uk/de/...), page, max_results(<=240/page), sort(best_match|newly_listed|ending_soonest|price_low|price_high), condition(new|used|refurbished|open_box|for_parts), category, buy_it_now, auction. seller is item-page-only.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for (item keywords). |
| sort = best_match | optional | best_match · newly_listed · ending_soonest · price_low · price_high · price_asc · price_desc | Result ordering. |
| condition | optional | new · open_box · refurbished · used · for_parts | Only items in this condition (empty = all conditions). |
| category | optional | — | eBay category ID to narrow results — the number in an eBay category URL (e.g. 9355 = Cell Phones & Smartphones). Leave empty for all categories. |
| buy_it_now = false | optional | — | Only fixed-price (Buy It Now) listings. |
| auction = false | optional | — | Only auction listings. |
| domain = com | optional | com · co.uk · de · com.au · ca · fr · it · es · nl · at · ch · ie · pl | Which eBay site to query (sets currency and local listings). Dropdown = the 13 live-verified sites; other eBay country sites (e.g. com.sg, com.hk) are also accepted. |
| page = 1 | optional | 1– | Page number (easy paging: 1, 2, 3…). |
| max_results = 60 | optional | 1–240 | How many results to return (1–240 per page; larger values are capped at 240). |
/ebay/v1/sold_search2 credits⭐SOLD/completed search by `query` (LH_Sold=1&LH_Complete=1, bare, NOT login-gated) -> results[]{...,sold_price{value,currency},sold_date} + price_stats{count,min,max,avg,median,stdDev,p10/p25/p75/p90,recommendedPrice(IQR-trimmed),outliers_removed,per_condition{bucket:{count,median,avg,min,max}},velocity{sales_per_day,days_to_sell,recent_sales_per_day,sales_last_7d/30d,span_days},trend{direction,slope_per_day,pct_change}} — ALL derived from the sold-array+sold_date, NO extra fetch (AI-free comps math). Same filters as search. The price-research moat.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to search for (item keywords). |
| condition | optional | new · open_box · refurbished · used · for_parts | Only items in this condition (empty = all conditions). |
| category | optional | — | eBay category ID to narrow results — the number in an eBay category URL (e.g. 9355 = Cell Phones & Smartphones). Leave empty for all categories. |
| domain = com | optional | com · co.uk · de · com.au · ca · fr · it · es · nl · at · ch · ie · pl | Which eBay site to query (sets currency and local listings). Dropdown = the 13 live-verified sites; other eBay country sites (e.g. com.sg, com.hk) are also accepted. |
| page = 1 | optional | 1– | Page number (easy paging: 1, 2, 3…). |
| max_results = 60 | optional | 1–240 | How many results to return (1–240 per page; larger values are capped at 240). |
/ebay/v1/item_detail2 creditsFull eBay item detail by item_id or listing URL: title, price, list price, currency, condition, availability, brand, model, MPN, images, category path, item specifics, seller (name, feedback score, review count), shipping terms, and return policy.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| item_id | optional | — | eBay item number — the digits in the listing URL after /itm/. Provide item_id OR url (one of the two is required). |
| url | optional | — | Full eBay listing URL — alternative to item_id. |
| domain = com | optional | com · co.uk · de · com.au · ca · fr · it · es · nl · at · ch · ie · pl | Which eBay site to query (sets currency and local listings). Dropdown = the 13 live-verified sites; other eBay country sites (e.g. com.sg, com.hk) are also accepted. |
curl -X POST https://api.reefapi.com/ebay/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 13 pro"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}