# TCGplayer Product API Documentation

<p>Get one TCGplayer product by numeric id from a search result. The response has the name, set, number, rarity, full-size image and prices, plus skus with condition, variant, language and prices by condition. Prices are numbers with USD. An unknown id returns 404 and is not billed. One credit per successful request.</p>

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

## 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 tcgplayer.com product url with a numeric id. Send url or id. |
| `id` | string | Yes | Numeric product id from a TCGplayer search. |

## Example response

```json
{
    "data": {
        "product": {
            "id": "42382",
            "name": "Charizard",
            "skus": [
                {
                    "id": "1001",
                    "variant": "Normal",
                    "language": "English",
                    "condition": "Near Mint"
                }
            ],
            "prices": {
                "market": {
                    "amount": 125.5,
                    "currency": "USD"
                }
            }
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Product Not Found | TCGplayer does not know this product. 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)
