eBay API — Getting Started — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Getting Started

Find the listings you care about, re-check their prices on a schedule, and read the seller and product reputation behind them.

1. Get your API key

Create an account and generate a FetchLayer API key from your dashboard. There is no eBay developer program application, no keyset and no OAuth flow involved.

Create free account →

2. Search listings

Search by keyword, category or seller. Each listing carries its itemId — the identifier price-check and listing-details take.

bash
curl -X POST https://api.fetchlayer.dev/ebay/search-listings \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"anker usb c charger","condition":["new"],"sort":"price_lowest","limit":60}'

Tip

Already have an eBay link? Send it to /resolve-url first — it returns the item number, username, product id or search filters the URL encodes, and it does not consume a credit.

3. Monitor prices in bulk

/price-check takes up to 100 item numbers and returns each one's current price, shipping cost and status. In the default fast mode listings are answered up to 50 at a time, so re-checking a watchlist costs little more than checking one listing.

bash
curl -X POST https://api.fetchlayer.dev/ebay/price-check \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"listings":["334140575100","326634081605","335571739480"]}'

Nothing goes silently missing

Every listing you ask for comes back. One that has ended is reported as ended with its final price, one that has been removed as not_found. Use "mode":"exact" when you also need the seller's own currency and the exact quantity available.

Current prices only

Sold and completed prices are shown by eBay to signed-in members only, so they are not available. Prices are in US dollars and shipping is quoted to the United States.

4. Check the seller

/seller-feedback returns the feedback score, 1-, 6- and 12-month rating counts, detailed seller ratings and the individual comments. Set includeAutomated to false to skip eBay's automatic on-time-delivery entries and read only what buyers wrote.

bash
curl -X POST https://api.fetchlayer.dev/ebay/seller-feedback \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"seller":"vipoutlet","rating":"negative","includeAutomated":false,"limit":50}'

5. Read product reviews

Reviews belong to eBay's catalogue product, not to a single listing. A listing's item specifics carry the id as eBay Product ID (ePID).

bash
curl -X POST https://api.fetchlayer.dev/ebay/product-reviews \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"product":"27061041202","limit":50}'

Next steps