# Newegg API
> Live product search from Newegg.com, the major electronics & tech retailer. Search any keyword — laptop, rtx 4070, ssd — and get the product listings with title, brand, model, current price, original price, image, rating, review count, in-stock status, seller and the Newegg product URL. Prices are live USD. Ideal for shopping, price-comparison, deal-tracking and e-commerce dashboards.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/newegg-api/..."
```

## Pricing
- **Free** (Free) — 500 calls/Mo, 2 req/s
- **Starter** ($15/Mo) — 15,000 calls/Mo, 6 req/s
- **Pro** ($59/Mo) — 75,000 calls/Mo, 16 req/s
- **Business** ($249/Mo) — 500,000 calls/Mo, 40 req/s

## Endpoints

### Products

#### `GET /v1/product` — One product in full by Newegg item number

**Parameters:**
- `item` (query, required, string) — Newegg item number (from /v1/search) Example: `9SIBFJRKFE0326`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/newegg-api/v1/product?item=9SIBFJRKFE0326"
```

**Response:**
```json
{
    "data": {
        "sku": "N82E16820156412",
        "url": "https://www.newegg.com/p/9SIBFJRKFE0326",
        "gtin": "649528942081",
        "item": "9SIBFJRKFE0326",
        "name": "Crucial P310 M.2 2280 1TB PCI-Express 4.0 x4 NVMe 3D NAND Internal Solid State Drive Speed Up to 7100 MBps (SSD) CT1000P310SSD8",
        "brand": "Crucial",
        "image": "https://c1.neweggimages.com/ProductImage/20-156-411-01.jpg",
        "model": "CT1000P310SSD8",
        "price": 178.55,
        "images": [
            "https://c1.neweggimages.com/ProductImage/20-156-411-01.jpg"
        ],
        "rating": 5,
        "source": "Newegg",
        "reviews": 89,
        "currency": "USD",
        "in_stock": true,
        "condition": "NewCondition",
        "description": "Crucial P310 M.2 2280 1TB PCI-Express 4.0 x4 NVMe 3D NAND Internal Solid State Drive Speed Up to 7100 MBps (SSD) CT1000P310SSD8",
        "availability": "InStock"
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:42.835Z",
        "request_id": "c785f16c-a4c0-4980-8515-466ea2698e23"
    },
    "status": "ok",
    "message": "Product retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search Newegg products by keyword

**Parameters:**
- `q` (query, required, string) — Search keyword (e.g. laptop, rtx 4070, ssd) Example: `laptop`
- `page` (query, optional, string) — Result page (default 1) Example: `1`
- `limit` (query, optional, string) — Results per page (1-96, default 24) Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/newegg-api/v1/search?q=laptop&page=1&limit=24"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 24,
        "query": "laptop",
        "source": "Newegg",
        "products": [
            {
                "url": "https://www.newegg.com/p/1TS-000E-1DK92",
                "item": "1TS-000E-1DK92",
                "brand": "Lenovo",
                "image": "https://c1.neweggimages.com/ProductImageCompressAll1280/A8X5S2511110Z4BPK2A.jpg",
                "model": "82XM00LMUS",
                "price": 599.99,
                "title": "Lenovo - IdeaPad Slim 3 15.6\" Full HD Touchscreen Laptop - AMD Ryzen 7 5825U - 16GB Memory - 512GB SSD - Arctic Grey",
                "rating": null,
                "seller": "Newegg",
                "reviews": null,
                "in_stock": true,
                "original_price": null
            },
            {
                "url": "https://www.newegg.com/p/9SIAGHSGUG6199",
                "item": "9SIAGHSGUG6199",
                "brand": "HP",
                "image": "https://c1.neweggimages.com/ProductImageCompressAll1280/AGHSS2201130B8VQNF6.jpg",
                "model": "15-dw3033dx, 512",
                "price": 321,
                "title": "HP 15.6\" FHD Laptop, Intel Core i3-1115G4 processor - 8GB Memory - 512GB SSD - Natural Silver",
                "rating": null,
                "seller": "SeekNFind",
                "reviews": null,
                "in_stock": true,
                "original_price": null
            },
            {
                "url": "https:
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/newegg-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "search takes q (a keyword like laptop, rtx 4070, ssd), optional page and limit (1-96). Prices are USD and live; ratings/reviews are Newegg's. Results are not cached.",
        "sample": {
            "price": 599.99,
            "title": "Lenovo - IdeaPad Slim 3 15.6\" Full HD Touchscreen Laptop - AMD Ryzen 7 5825U - 16GB Memory - 512GB SSD - Arctic Grey"
        },
        "source": "Newegg public search (newegg.com/p/pl, live)",
        "service": "newegg-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/search": "Search Newegg products by keyword (q=laptop, page, limit)."
        },
        "description": "Live product search from Newegg.com, the major electronics & tech retailer, keyless via proxy. For any keyword: the product listings with title, brand, model, current price, original price, image, rating, review count, in-stock status, seller and the Newegg product URL. Data is read from the page's embedded catalogue JSON, not fragile HTML scraping. The electronics-product-search/price layer for shopping, comparison and deal apps. Distinct from price-comparison aggregators — Newegg's own catalogue and live prices.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-13T22:56:01.047Z",
        "request_id": "b5e36148-da46-4b8a-91c6-e4495c71c87e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

### Catalogue

#### `GET /v1/category` — Browse a Newegg category by node id

**Parameters:**
- `cat` (query, required, string) — Newegg category node id (the N= code from a Newegg category URL; see /v1/meta) Example: `100007709`
- `sort` (query, optional, string) — Sort: featured, price_asc, price_desc, best_selling, top_rated, most_reviews Example: `price_asc`
- `page` (query, optional, string) — Result page (default 1) Example: `1`
- `limit` (query, optional, string) — Results per page (1-96, default 24) Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/newegg-api/v1/category?cat=100007709&sort=price_asc&page=1&limit=24"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "sort": "price_asc",
        "count": 24,
        "source": "Newegg",
        "category": "100007709",
        "products": [
            {
                "url": "https://www.newegg.com/p/9SIACTNJ9A5767",
                "item": "9SIACTNJ9A5767",
                "brand": "NVIDIA",
                "image": "https://c1.neweggimages.com/ProductImageCompressAll1280/ACTN_1_202001061603280805.jpg",
                "model": "660499-003",
                "price": 19.54,
                "title": "Nvidia Geforce GT 520M 1GB Module PCI-E Laptop Graphic Card 660499-003 US Laptop Video Cards",
                "rating": null,
                "seller": "Ascendtech",
                "reviews": null,
                "in_stock": true,
                "original_price": null
            },
            {
                "url": "https://www.newegg.com/p/9SIADFRJBB4765",
                "item": "9SIADFRJBB4765",
                "brand": "AMD",
                "image": "https://c1.neweggimages.com/ProductImageCompressAll1280/ACTN_1_20190808451394825.jpg",
                "model": "716521-001",
                "price": 22.99,
                "title": "716521-001 717219-001 AMD ATI Radeon HD8490 1GB DDR3 DVI Displayport Video Card PCI-EXPRESS Video Cards",
                "rating": 5,
                "seller": "Computer Headquarters",
                "reviews": 0,
                "in_stock": true,
                "original_price": null
            },
        
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/newegg-api
OpenAPI spec: https://www.oanor.com/api/newegg-api/openapi.json
