# Newegg Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/newegg/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/newegg-product |

## Description

Newegg Product API: fetch full product page data from an item number, product ID or URL. Returns pricing, specs, images, ratings, seller info and promo codes via browser rendering.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/newegg/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### AMD Ryzen 5 9600X (N82E16819113844)

```json
{
  "upc": "730143315609",
  "url": "https://www.newegg.com/amd-ryzen-5-9000-series-ryzen-5-9600x-granite-ridge-socket-am5-desktop-cpu-processor/p/N82E16819113844",
  "brand": "AMD",
  "model": "100-100001405WOF",
  "price": 189.99,
  "title": "AMD Ryzen 5 9600X - Ryzen 5 9000 Series Granite Ridge (Zen 5) 6-Core 3.9 GHz - Socket AM5 65W - Radeon Graphics Processor - 100-100001405WOF",
  "images": [
    "https://c1.neweggimages.com/productimage/nb640/19-113-844-05.jpg",
    "https://c1.neweggimages.com/productimage/nb640/19-113-844-08.jpg"
  ],
  "rating": 4.8,
  "savings": 89.01,
  "currency": "USD",
  "in_stock": true,
  "image_url": "https://c1.neweggimages.com/productimage/nb640/19-113-844-05.jpg",
  "seller_id": null,
  "product_id": "N82E16819113844",
  "promo_code": "SSF69677",
  "breadcrumbs": [
    "Components & Storage",
    "CPU / Processor",
    "Desktop CPU Processor"
  ],
  "description": null,
  "item_number": "19-113-844",
  "seller_name": "Newegg",
  "subcategory": "Desktop CPU Processor",
  "availability": "in_stock",
  "review_count": 484,
  "bullet_points": [
    "Experience exceptional gaming performance with smooth 100+ FPS in the most popular games.",
    "This processor features 6 cores and 12 threads, based on AMD's \"Zen 5\" architecture."
  ],
  "original_price": 279,
  "promotion_text": "+ $10 off w/ promo code SSF69677, limited offer",
  "specifications": [
    {
      "key": "Brand",
      "group": "Model",
      "value": "AMD"
    },
    {
      "key": "CPU Socket Type",
      "group": "Details",
      "value": "Socket AM5"
    }
  ]
}
```

## Documentation

## Overview
The **Newegg Product API** returns full product page data from Newegg. Pass an **item number**, **product ID**, or **full product URL** and receive structured JSON with pricing, specs, images, ratings, seller info, and promo codes.

Piloterr uses **browser rendering** and parses embedded `window.__initialState__` from the PDP.

Use [Newegg Search](https://www.piloterr.com/library/newegg-search) to discover listings, then [Newegg Product](https://www.piloterr.com/library/newegg-product) for the full record.

## Quickstart
```
GET https://api.piloterr.com/v2/newegg/product?query=N82E16819113844
GET https://api.piloterr.com/v2/newegg/product?query=19-113-844
GET https://api.piloterr.com/v2/newegg/product?query=https://www.newegg.com/amd-ryzen-5-9000-series-ryzen-5-9600x-granite-ridge-socket-am5-desktop-cpu-processor/p/N82E16819113844
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Item number (`19-113-844`), product ID (`N82E168…`), or full PDP URL |
| `return_page_source` | boolean | no | Raw HTML as `{"result": "..."}` (default: `false`) |

## Input formats
| Format | Example |
|---|---|
| Product ID | `N82E16819113844` |
| Item number | `19-113-844` |
| Full URL | `https://www.newegg.com/…/p/N82E16819113844` |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Catalog (`N82E168…`) or marketplace (`9SI…`) ID |
| `item_number` | string | Internal Newegg item number |
| `title` | string | Product title |
| `url` | string | Canonical PDP URL |
| `brand` | string \| null | Brand |
| `model` | string \| null | Manufacturer model / MPN |
| `description` | string \| null | Long description |
| `bullet_points` | string[] \| null | Marketing bullet points |
| `image_url` | string \| null | Main image (640px) |
| `images` | string[] \| null | Full gallery |
| `price` | number | Final price |
| `original_price` | number | Strikethrough price |
| `savings` | number \| null | Discount amount |
| `currency` | string | `USD` |
| `in_stock` | boolean \| null | Raw availability |
| `availability` | string \| null | `in_stock` / `out_of_stock` |
| `rating` | number \| null | Rating out of 5 |
| `review_count` | integer \| null | Review count |
| `promotion_text` | string \| null | Display promo text |
| `promo_code` | string \| null | Extracted promo code (`PCode`) |
| `breadcrumbs` | string[] \| null | Category trail |
| `subcategory` | string \| null | Newegg subcategory |
| `specifications` | object[] \| null | Spec rows (`group`, `key`, `value`) |
| `seller_name` | string \| null | Seller (`Newegg` if first-party) |
| `seller_id` | string \| null | Marketplace seller ID |
| `upc` | string \| null | UPC code |

## Newegg API workflow
1. [Newegg Search](https://www.piloterr.com/library/newegg-search): discover listings
2. [Newegg Product](https://www.piloterr.com/library/newegg-product): full PDP JSON (this endpoint)

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` |
| `404` | Page without `__initialState__` or unparsable PDP |
| `500` | Rendering or parsing error |

## Notes
- Combo deal URLs (`ComboDealDetails`) are not supported by this endpoint.
- Costs **2 credits** per call (browser rendering).

## Main use cases
- **PDP enrichment**: specs, gallery, UPC, seller metadata
- **Promo monitoring**: track `promo_code` and `savings`
- **Inventory signals**: `availability` and price deltas