# Newegg Product API Documentation

<p><strong>Newegg Product API Documentation</strong> Read one Newegg product by item number or product url. The answer has the sale price, original price, discount, instant rebate, 30-day lowest price, promo text, volume discounts, shipping, stock, the seller (Newegg or a marketplace seller with rating), the ship-from country, rating, review count and photos. Newegg lists included marketplace shipping as 0.01: the API shows it as free shipping and keeps the listed value in shipping.listed_charge. The answer also has highlight specifications (name and value pairs) and bullets. The full specification table, other seller offers and Q&amp;A are not part of the answer. Cost: 2 credits per request. Failed requests are not billed. Not affiliated with Newegg.</p>

- **Documentation:** [https://scrappa.co/docs/newegg-api/newegg_product](https://scrappa.co/docs/newegg-api/newegg_product)
- **API group:** Newegg API
- **Endpoint:** `GET https://scrappa.co/api/newegg/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 |
| --- | --- | --- | --- |
| `item_number` | string | No | Newegg item number as search returns it: 14-137-771, N82E16814137771 or 9SIB3T1KEH4255. Required without url. |
| `url` | string | No | Newegg product url, for example https://www.newegg.com/p/N82E16814137771. Required without item_number. |
| `site` | string | No | com (default) or ca. Marketplace items (9SI) exist on com only. |

## Example response

```json
{
    "data": {
        "item": {
            "url": "https://www.newegg.com/p/N82E16814137771",
            "brand": "MSI",
            "image": "https://c1.neweggimages.com/ProductImageOriginal/14-137-771-02.jpg",
            "model": "RTX 4070 Ti GAMING X TRIO 12G",
            "price": {
                "amount": 809.99,
                "currency": "USD"
            },
            "promo": null,
            "title": "MSI Gaming GeForce RTX 4070 Ti Graphics Card RTX 4070 Ti GAMING X TRIO 12G",
            "images": [
                "https://c1.neweggimages.com/ProductImageOriginal/14-137-771-02.jpg",
                "https://c1.neweggimages.com/ProductImageOriginal/14-137-771-03.jpg"
            ],
            "rating": 4.7,
            "seller": {
                "id": null,
                "name": "Newegg",
                "rating": null,
                "is_newegg": true,
                "top_rated": false,
                "review_count": null
            },
            "bullets": [
                "12GB 192-Bit GDDR6X",
                "Boost Clock 2745 MHz",
                "1 x HDMI 2.1a 3 x DisplayPort 1.4a",
                "7680 CUDA Cores",
                "PCI Express 4.0"
            ],
            "category": "GPUs / Video Graphics Cards",
            "in_stock": false,
            "shipping": {
                "free": true,
                "price": {
                    "amount": 0,
                    "currency": "USD"
                },
                "listed_charge": 0.01
            },
            "item_number": "14-137-771",
            "review_count": 175,
            "instant_rebate": null,
            "is_marketplace": false,
            "original_price": {
                "amount": 899.99,
                "currency": "USD"
            },
            "specifications": [
                {
                    "name": "Max Resolution",
                    "value": "7680 x 4320"
                },
                {
                    "name": "DisplayPort",
                    "value": "3 x DisplayPort 1.4a"
                },
                {
                    "name": "HDMI",
                    "value": "1 x HDMI 2.1a"
                },
                {
                    "name": "DirectX",
                    "value": "DirectX 12 Ultimate"
                },
                {
                    "name": "Chipset Manufacturer",
                    "value": "NVIDIA"
                },
                {
                    "name": "Brand",
                    "value": "MSI"
                },
                {
                    "name": "Series",
                    "value": "Gaming"
                },
                {
                    "name": "Interface",
                    "value": "PCI Express 4.0"
                }
            ],
            "discount_amount": {
                "amount": 90,
                "currency": "USD"
            },
            "is_lowest_price": false,
            "discount_percent": 10,
            "volume_discounts": [],
            "ship_from_country": null,
            "limit_per_customer": 20,
            "lowest_price_30_days": null
        },
        "site": "com",
        "currency": "USD"
    },
    "meta": {
        "credits": 2,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | Newegg has no item with this number. This response is not billable. |
| 503 | Upstream Unavailable | Newegg did not answer or sent an answer Scrappa cannot read. This response is not billable. Retry later. |

## 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)