The eBay sold listings API for a SaaS app with 20,000+ searches a month

One request is one search, whether it returns 10 sales or 240. Count the searches your users run (plus any nightly repricing jobs), then pick the plan with headroom:

Annual billing costs 10 months for 12. Spikes above the plan use credits at $5 per 1,000 that never expire. Full table on the pricing page.

Commercial use is permitted on every plan, including free. You can build sold-price data into a paid SaaS, a mobile app, an internal tool or a client deliverable, and what you build on top is yours. The one thing the terms rule out is reselling raw API access as a competing data API.

Call the API from your server, show the median and range, and keep the sales as evidence. Treat the two kinds of HTTP 429 differently: wait and retry a per-minute rate_limited, but never loop on quota_exceeded.

// Server-side only: never ship the API key to the browser.
const res = await fetch(
  "https://api.compsniper.com/v1/scrape?" + new URLSearchParams({
    keyword: userQuery,          // what your user typed
    count: "240",
    bestOfferPrice: "true",      // real accepted Best Offer prices
    ebaySite: "ebay.com",        // or ebay.co.uk, ebay.de, ...
  }),
  { headers: { Authorization: `Bearer ${process.env.COMPSNIPER_API_KEY}` } }
);

if (res.status === 429) {
  const body = await res.json();
  if (body.code === "quota_exceeded") notifyOps(body);   // plan used up: never retry in a loop
  else await sleep(Number(res.headers.get("Retry-After") ?? 2) * 1000); // per-minute limit: wait, retry
}

const data = await res.json();
// data.summary: median, p25, p75, mean, min, max, avgShipping
// data.items: up to 240 sales, 26 fields each
// res.headers X-Usage-Remaining: slow down before you reach zero

Same pattern in Python: the Python guide. Full contract: the API reference.

• Keys stay on the server. Use one key per environment.
• Pick raw or cleaned per feature. The default removes accessories, parts and wrong models; relevance=false returns eBay's results exactly as listed.
• Show what buyers paid. bestOfferPrice=true adds acceptedOfferPrice on accepted Best Offer sales.
• Go past 90 days when it matters. GET /v1/research/sold returns up to 3 years on every plan.
• Batch the heavy work. Bulk search (20 keywords), Card Batch (100 cards) and Max Mode (beyond 240 rows with CSV) run as background jobs.
• Watch your allowance. Read X-Usage-Remaining on every response.

How we keep the API up: reliability.

Frequently asked questions

eBay sold data for SaaS products