# PriceCharting Price History API Documentation

<p>Get six dated price history series for a PriceCharting product from the chart state embedded in the product page: boxonly, cib, graded, manualonly, new and used. Each point has an ISO 8601 date and a price as a number with USD. No extra upstream lookup is made. One credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/pricecharting-api/pricecharting_price_history](https://scrappa.co/docs/pricecharting-api/pricecharting_price_history)
- **API group:** PriceCharting API
- **Endpoint:** `GET https://scrappa.co/api/pricecharting/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 |
| --- | --- | --- | --- |
| `url` | string | No | A pricecharting.com game url. |
| `id` | string | No | A game path from a search, such as pokemon-base-set/charizard-4. |

## Example response

```json
{
    "data": {
        "id": "pokemon-base-set/charizard-4",
        "series": {
            "used": [
                {
                    "date": "2026-08-01T00:00:00Z",
                    "price": {
                        "amount": 1195,
                        "currency": "USD"
                    }
                }
            ]
        },
        "product": {
            "id": "pokemon-base-set/charizard-4",
            "product_id": "630417"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "price-history"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Product Not Found | PriceCharting does not know this product. Not billed. |
| 503 | Upstream Unavailable | PriceCharting 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)
