Bulk Endpoints

Bulk Endpoints

Bulk endpoints let you fetch data for multiple cards in a single request. Available on Pro and Business tiers.

Bulk Card Prices

GET /v1/bulk/prices?ids=1,2,3,...

Authentication: API key required (Pro tier)

Fetch prices for up to 500 cards in one request.

Query Parameters:

Parameter	Type	Description
ids	string	Comma-separated card IDs (max 500)

Example:

curl "https://api.tcgapi.dev/v1/bulk/prices?ids=12345,12346,12347" \
  -H "X-API-Key: YOUR_PRO_KEY"

Response:

{
  "data": [
    {
      "card_id": 12345,
      "market_price": 24.99,
      "low_price": 19.50,
      "foil_market_price": null,
      "price_change_24h": 2.15,
      "last_updated_at": "2026-02-19T07:00:00.000Z"
    },
    {
      "card_id": 12346,
      "market_price": 1.50,
      "low_price": 0.99,
      "foil_market_price": 3.25,
      "price_change_24h": -0.50,
      "last_updated_at": "2026-02-19T07:00:00.000Z"
    }
  ]
}

Bulk Card Data

GET /v1/bulk/cards?ids=1,2,3,...

Authentication: API key required (Pro tier)

Fetch full card data for up to 100 cards in one request.

Query Parameters:

Parameter	Type	Description
ids	string	Comma-separated card IDs (max 100)

Bulk Price History

GET /v1/bulk/history?ids=1,2,3,...

Authentication: API key required (Business tier)

Fetch price history for up to 50 cards in one request.

Query Parameters:

Parameter	Type	Description
ids	string	Comma-separated card IDs (max 50)
range	string	month, quarter, or year (default: month)

Set Data Export

GET /v1/export/set/:id

Authentication: API key required (Business tier)

Download all card and price data for an entire set.

Query Parameters:

Parameter	Type	Description
format	string	json (default) or csv

Example:

# Download as CSV
curl "https://api.tcgapi.dev/v1/export/set/1234?format=csv" \
  -H "X-API-Key: YOUR_BUSINESS_KEY" \
  -o obsidian-flames.csv