eBay Sold Comps API

Find & Flip provides an asynchronous API for eBay sold-listing searches. Submit keywords, poll the job, and retrieve structured sold-listing data for resale research or your own tools.

Read the public docs Create an API key

What the API does

eBay Sold Comps API, explained

Find & Flip provides an asynchronous API for eBay sold-listing searches. Submit keywords, poll the job, and retrieve structured sold-listing data for resale research or your own tools.

Pricing in USD

$1.00 / 1,000 listings

20 returned listings cost $0.02 at standard rates. Prepaid API credits start at $10. No API subscription is required; API credits are separate from sourcing plans and AI credits.

Creating a search reserves its maximum cost. Only returned listings are billed; unused reservations are released. Status checks, repeated result reads, and empty searches have no listing charge. Custom account rates are shown by GET /api/v1/balance.

Supported markets and coverage

eBay sold-listing searches with a configurable 1–90 day search window. The window is a search filter, not a promise of complete historical coverage. Responses expose the source currency; do not assume every result is in USD.

Searches are asynchronous. Results depend on source availability and worker capacity; no fixed response time or completeness guarantee is advertised.

Request and response examples

Documentation is public. A verified account, an API key, and sufficient prepaid credits are required to run searches.

1. Submit a search

curl -X POST 'https://findandflip.io/api/v1/jobs' \
  -H 'Authorization: Bearer ffapi_YOUR_KEY' \
  -H 'Idempotency-Key: example-search-001' \
  -H 'Content-Type: application/json' \
  -d '{"marketplace": "ebay", "query": "Nintendo Switch OLED 64GB console", "maxResults": 20, "daysToScrape": 30}'

The response includes an id and job status. Save that ID.

2. Poll status, then read results

GET /api/v1/jobs/{job_id}
GET /api/v1/jobs/{job_id}/results?offset=0&limit=50

Send the same Bearer header for reads. Poll every 2–5 seconds. Read results after completed; requesting them earlier returns 409.

Illustrative results JSON

Synthetic example only. These are not live listings or verified sales. Source fields vary and can be missing or null. eBay soldPrice is numeric; other marketplaces expose price as source text.

{
  "jobId": "67b201a6-c3b5-49fc-9f82-d3e50281e761",
  "marketplace": "ebay",
  "offset": 0,
  "count": 1,
  "total": 1,
  "items": [
    {
      "marketplace": "ebay",
      "itemId": "illustrative-item",
      "title": "Nintendo Switch OLED console",
      "soldPrice": 220.0,
      "currency": "USD",
      "condition": "Used",
      "soldDate": "2026-10-30"
    }
  ]
}

Limits and important distinctions

This is sold-listing research, not a verified transaction ledger or an official eBay API. Observed sold prices can differ from a buyer's final payment, including negotiated offers, shipping, and taxes. Matching titles alone does not establish an equivalent model, condition, or bundle. Results are not automatically validated comps or appraisals.

Request 1–240 results per search; fewer may be returned.
120 requests per key per minute; normally two active searches per account, subject to worker capacity.
Use the same Idempotency-Key and request body when retrying. A new key creates an independently billable search.
Respect Retry-After on 429 responses. Failed or cancelled jobs release their reservation; completed jobs retain their final charge.
Find & Flip supplies listing research. You remain responsible for checking condition, authenticity, fees, and resale assumptions.

All parameters · Errors and limits · OpenAPI schema · Ask about coverage or volume pricing

eBay Sold Comps API