CompSniper documentation
Build with marketplace listings, price summaries, shipping-rate estimates, batch workflows, and MCP tools.
CompSniper searches public eBay, Poshmark, and Mercari marketplace listings through one authenticated API. The separate Shipping Rates API returns US route and package estimates with the same API key. Use the REST API from your application or connect the hosted MCP server to an AI client.
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 with cURL, Python, or Node.js.
- Authenticate safely with a bearer API key.
- Handle rate limits without creating retry storms.
- Read every error code and know which failures are retryable.
- Review the complete API reference for parameters and response fields.
Main workflows
- Keyword and category sold searches
- Poshmark and Mercari marketplace searches
- US shipping-rate estimates
- Asynchronous sports and trading-card batches
- Hosted MCP for Claude, ChatGPT, Codex, Cursor, and other clients
- Max Mode for deep server-side pagination
- RapidAPI billing and authentication
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 |
| 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 |
| History | About 90 days on /v1/scrape, up to 3 years on /v1/research/sold |
| 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 contains tested Python, Node.js, cURL, pagination, retry, and Card Batch examples.