# CompSniper documentation

> The CompSniper eBay sold listings API, with up to 240 sold listings per request, 3 years of eBay sold history, accepted Best Offer prices, TCGplayer, PSA, Goldin, Fanatics Collect and more. Free 100 requests a month, then from $9.

Canonical HTML: https://compsniper.com/docs
Markdown source: https://compsniper.com/docs/index.md
Generated from the maintained CompSniper MDX source at build time.

Short answer: CompSniper is an eBay sold listings API. One GET request returns up to 240 real eBay sold
listings with price, sale date, condition, shipping and seller, on 8 eBay marketplaces. The same API key also
returns 3 years of eBay sold history, the accepted price on Best Offer sales, TCGplayer sales, PSA prices and
population, auction results from Goldin, Fanatics Collect, Pristine Auction and MySlabs, and listings from
Grailed, Poshmark, Mercari and Depop.

Pricing: free for 100 requests a month, then Starter $9 for 2,000, Growth $29 for 10,000 or Scale $79 for
50,000 requests ([all plans](https://compsniper.com/pricing)). Failed requests are never charged. Use the REST API from your
application or connect the hosted MCP server to Claude, ChatGPT or another AI client. The separate Shipping
Rates API returns US route and package estimates with the same API key.

Every eBay sold search lets you choose: `relevance=false` returns the raw results exactly as eBay lists
them, and the default adds AI relevance cleanup (with the raw median still reported) before the price summary.

## Start here

- [Make your first request](https://compsniper.com/docs/quickstart) with cURL, Python, or Node.js.
- [Authenticate safely](https://compsniper.com/docs/authentication) with a bearer API key.
- [Handle rate limits](https://compsniper.com/docs/rate-limits) without creating retry storms.
- [Read every error code](https://compsniper.com/docs/errors) and know which failures are retryable.
- [Review the complete API reference](https://compsniper.com/docs/api-reference) for parameters and response fields.

## Main workflows

- [Keyword and category sold searches](https://compsniper.com/docs/api-reference)
- [Poshmark and Mercari marketplace searches](https://compsniper.com/docs/marketplaces)
- [US shipping-rate estimates](https://compsniper.com/docs/shipping-rates)
- [Asynchronous sports and trading-card batches](https://compsniper.com/docs/card-batch)
- [Hosted MCP for Claude, ChatGPT, Codex, Cursor, and other clients](https://compsniper.com/docs/mcp)
- [Max Mode for deep server-side pagination](https://compsniper.com/docs/max-mode)
- [RapidAPI billing and authentication](https://compsniper.com/docs/rapidapi)

## Service basics

| Capability | Value |
| --- | --- |
| REST base URL | `https://api.compsniper.com` |
| Main endpoint | `GET /v1/scrape` |
| Sold history endpoint | `GET /v1/research/sold` (up to 3 years) |
| TCGplayer endpoints | `GET /v1/tcgplayer/sold`, `GET /v1/tcgplayer/listings` |
| Grailed endpoints | `GET /v1/grailed/sold`, `GET /v1/grailed/listings` |
| Depop endpoint | `GET /v1/depop/listings` |
| Shipping endpoint | `POST /v1/shipping/rates` |
| Authentication | `Authorization: Bearer cs_live_...` |
| Results per page | Up to 240 sold listings |
| Marketplaces | eBay US, UK, DE, FR, IT, ES, CA, AU; Poshmark US; Mercari US; TCGplayer; Grailed; Depop US, UK, AU, CA |
| History | About 90 days on `/v1/scrape`, up to 3 years on [`/v1/research/sold`](https://compsniper.com/docs/sold-history) |
| Free plan | 100 requests each month |

Every production endpoint is versioned under `/v1` and returns JSON. eBay and Mercari prices use decimal
strings to avoid floating-point rounding; Poshmark keeps numeric prices in its dedicated native schema.

## Need working projects?

The [public examples repository](https://github.com/CompSniper/compsniper-api-examples) contains tested
Python, Node.js, cURL, pagination, retry, and Card Batch examples.

---

CompSniper is independent and is not affiliated with or endorsed by eBay, Poshmark, or Mercari.
Support: support@compsniper.com