TCGplayer

TCGplayer product search

Search TCGplayer products by keyword; returns catalog identity, source market-price estimate and a few active seller asks. Cached 15 minutes; a cache miss returns 202 to poll.

get/tcgplayer/search

Request

  • Base URL: https://api.soldgraph.com/v1
  • URL: https://api.soldgraph.com/v1/tcgplayer/search
  • Auth: HTTP bearer

Query parameters

qstring required

Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.

pageinteger

Source page to fetch. Where an endpoint has cursor, pages after 1 also need it.

country'us'

Only us is supported here. eBay, Vinted, Poshmark, Depop and Whatnot endpoints also take other countries. Mercari, OfferUp, Facebook Marketplace and TCGplayer are US only.

marketplace'tcgplayer'

Optional; must match the path.

countinteger

Products per source page.

product_linestring

Keep one product line, named as TCGplayer does: Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana and so on. Case doesn't matter. Leave it out to search every line.

Headers

Idempotency-Keystring

Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.

Response

Complete, including cache hits. Costs 1 request.

request_idstring required

ID of this request. Poll it at /v1/jobs/{request_id}.

status'pending' | 'complete' | 'failed' required

pending, complete or failed. Always check it, even on HTTP 200.

creditsinteger required

Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed.

cachedboolean required

True when the result came from the 15-minute cache.

poll_urlstring

Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL.

Changes

No recorded changes to this operation across all 1 revision of this API.