# TCGplayer Price History API Documentation

<p>Get dated price history for a TCGplayer product id. Choose month, quarter, semi-annual, semiannual or annual. Each point has a date as ISO 8601 and market, low sale and high sale prices as numbers with USD, plus quantity sold, transactions and trend percent. Invalid ranges return 422 before any upstream call. One credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/tcgplayer-api/tcgplayer_price_history](https://scrappa.co/docs/tcgplayer-api/tcgplayer_price_history)
- **API group:** TCGplayer API
- **Endpoint:** `GET https://scrappa.co/api/tcgplayer/price-history`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Numeric product id from a TCGplayer search. |
| `range` | string | Yes | month, quarter, semi-annual, semiannual or annual. |

## Example response

```json
{
    "data": {
        "id": "42382",
        "count": 1,
        "range": "quarter",
        "series": [
            {
                "points": [
                    {
                        "date": "2026-08-01T00:00:00Z",
                        "market_price": {
                            "amount": 990,
                            "currency": "USD"
                        }
                    }
                ],
                "sku_id": "101",
                "condition": "Near Mint"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "price-history"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id or range is invalid. Not billed. |
| 503 | Upstream Unavailable | TCGplayer did not answer. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
