# SocialCrawl API — ebay endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/ebay

## GET /v1/ebay/search
Search eBay listings
Credit cost: 5 (advanced)
Parameters:
- query (required) — Free-text listing search, for example airpods pro or vintage seiko.
- country (optional, enum: US | GB | AU | CA | DE | FR | IT | ES | IE | AT | CH | NL | BE | PL | SG | MY | PH | HK | MX) — eBay marketplace as a two-letter country code: US (ebay.com, default), GB, AU, CA, DE, FR, IT, ES, IE, AT, CH, NL, BE, PL, SG, MY, PH, HK, or MX. The marketplace sets the listing pool, language, and currency.
- page (optional, integer) — Page number, starting at 1. Prefer the universal cursor parameter.
- sort_by (optional, enum: best_match | price_low | price_high | newly_listed | ending_soonest) — Result ordering: best_match (default), price_low, price_high, newly_listed, or ending_soonest.
- condition (optional, enum: new | refurbished | used) — Restrict to one item condition: new, refurbished, or used.
- buying_format (optional, enum: auction | buy_it_now | accepts_offers) — Restrict to one sale type: auction, buy_it_now, or accepts_offers.
- show_only (optional, string) — Restrict results. sold_items returns listings that ended in a sale (price is the realised sale; product.ext.sold_at is the sold date). completed_items returns all ended listings, including those that did not sell. Combine with a comma, for example sold_items,completed_items. free_shipping is also accepted. No eBay login or cookie is required.
- min_price (optional, string) — Lowest price to include. Applied by eBay and approximate, so filter on product.price.current if you need a hard bound.
- max_price (optional, string) — Highest price to include. Applied by eBay and approximate, so filter on product.price.current if you need a hard bound.
- aspects (optional, string) — Category-specific item aspect filter taken from a previous response, for example Brand:Apple.
curl "https://www.socialcrawl.dev/v1/ebay/search?query=airpods pro" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/ebay/product
Get an eBay listing by item id
Credit cost: 5 (advanced)
Parameters:
- product_id (required) — eBay item id, the numeric id in a listing URL: ebay.com/itm/327256602116 is item id 327256602116. Item ids also come back on every row of GET /v1/ebay/search.
- country (optional, enum: US | GB | AU | CA | DE | FR | IT | ES | IE | AT | CH | NL | BE | PL | SG | MY | PH | HK | MX) — eBay marketplace as a two-letter country code: US (ebay.com, default), GB, AU, CA, DE, FR, IT, ES, IE, AT, CH, NL, BE, PL, SG, MY, PH, HK, or MX. The marketplace sets the listing pool, language, and currency.
curl "https://www.socialcrawl.dev/v1/ebay/product?product_id=327256602116" \
  -H "x-api-key: sc_your_api_key_here"