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 | Required |
|---|---|
| query | required |
| domain | optional |
| page | optional |
| max_results | optional |
| sort | optional |
| condition | optional |
| category | optional |
| buy_it_now | optional |
| auction | optional |
/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 | Required |
|---|---|
| query | required |
| domain | optional |
| page | optional |
| max_results | optional |
| condition | optional |
| category | optional |
/ebay/v1/item_detail2 creditsfull item by `item_id` OR `url`: title/price/list_price/currency/condition/availability/brand/model/mpn/images[]/category_path/item_specifics{}/seller{name,feedback_pct,feedback_count}/shipping/return_policy. From Product + ux item-specifics.
| Parameter | Required |
|---|---|
| item_id | optional |
| url | optional |
| domain | optional |
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
}