# Newegg Electronics API — product search, detail, customer reviews, Q&A, category listings, and deals from newegg.com (US)

> Search Newegg products by keyword with page pagination, sort (price/best-selling/rating), brand/facet filter, and a price range
> ReefAPI engine `newegg` · 13 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/newegg/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /newegg/v1/search — 1 credit
Search Newegg products by keyword with page pagination, sort (price/best-selling/rating), brand/facet filter, and a price range

**Parameters:**
- `query` (string, required) — Search keyword.
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.
- `sort` (enum, optional, default "0") — Sort order: 0=Featured, 1=Lowest Price, 2=Highest Price, 3=Best Selling, 4=Best Rating, 5=Most Reviews. [one of: 0, 1, 2, 3, 4, 5]
- `n_value` (string, optional) — Newegg 'N' facet filter value (from the filters action) — e.g. a brand or attribute facet. Combine space-separated for multiple facets.
- `min_price` (number, optional) — Minimum price (USD).
- `max_price` (number, optional) — Maximum price (USD).

**Returns:** results[] (title, brand, price, list_price, rating, review_count, image, url), page, total, has_more, next_page

**Example request body:**
```json
{
  "query": "ssd"
}
```

### POST /newegg/v1/product — 1 credit
Full product detail by item_id or url — price, list price, promotion, brand, model, GTIN, specifications, bullets, images, rating, stock, and marketplace seller

**Parameters:**
- `item_id` (string, optional) — Newegg item id (the N82E... code in a /p/ URL).
- `url` (string, optional) — Full Newegg product URL (overrides item_id when both are given).

**Returns:** product{} — title, brand, price, promotion, seller, specs, bullets, images, rating, in_stock, availability (item_id or url required)

**Example request body:**
```json
{
  "item_id": "N82E16820156412"
}
```

### POST /newegg/v1/reviews — 1 credit
Customer reviews for a Newegg product — fully paginated through ALL reviews (20/page) with rating filter and sort, plus a rating distribution summary. Returns rating, title, body, pros/cons, author, verified-purchase, helpful votes, media, and merchant replies

**Parameters:**
- `item_id` (string, required) — Newegg item id (the N82E... code in a /p/ URL).
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.
- `rating` (integer, optional) — Filter to a single star rating (1-5). Omit for all.
- `sort` (enum, optional, default "1") — Review sort: 1=Most Recent, 2=Most Helpful, 3=Highest Rating, 4=Lowest Rating. [one of: 1, 2, 3, 4]
- `url` (string, optional) — Full Newegg product URL (overrides item_id when both are given).

**Returns:** reviews[] (rating, title, text, pros, cons, author, verified_purchase, helpful_votes, media), rating_summary{total_count, average_rating, rating_distribution}, page, total, has_more, next_page

**Example request body:**
```json
{
  "item_id": "N82E16820156412"
}
```

### POST /newegg/v1/best_sellers — 1 credit
Top best-selling products for a keyword or category (Newegg's Best Selling sort), paginated

**Parameters:**
- `query` (string, required) — Keyword or category to rank by best-sellers.
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.
- `min_price` (number, optional) — Minimum price (USD).
- `max_price` (number, optional) — Maximum price (USD).

**Returns:** results[] best-selling products (title, brand, price, rating, review_count, url), page, total, has_more, next_page

**Example request body:**
```json
{
  "query": "ssd"
}
```

### POST /newegg/v1/qna — 1 credit
product Q&A questions and answers from PDP initial state

**Parameters:**
- `item_id` (string, required) — Newegg item id (the N82E... code in a /p/ URL).
- `url` (string, optional) — Full Newegg product URL (overrides item_id when both are given).

**Returns:** questions[] {question, author, answers[], answer_count, upvotes}

**Example request body:**
```json
{
  "item_id": "N82E16820156412"
}
```

### POST /newegg/v1/category — 1 credit
Browse a Newegg subcategory's product listing by subcategory_id, paginated. The slug is auto-resolved when omitted (pass subcategory_slug from category_tree to skip the lookup)

**Parameters:**
- `subcategory_id` (string, required) — Newegg subcategory id (from the category_tree action).
- `subcategory_slug` (string, optional) — Category slug from category_tree (e.g. 'Desktop-Memory'). Optional — auto-resolved from the id when omitted.
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.

**Returns:** results[] listing cards, subcategory_id, subcategory_slug, page, total, has_more, next_page

### POST /newegg/v1/browse — 1 credit
Alias of the category action — browse a subcategory's product listing, paginated

**Parameters:**
- `subcategory_id` (string, required) — Newegg subcategory id (alias of the category action).
- `subcategory_slug` (string, optional) — Category slug from category_tree (optional).
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.

**Returns:** results[] listing cards (same as category), page, total, has_more, next_page

### POST /newegg/v1/deals — 1 credit
Shell Shocker daily deal items

**Parameters:**
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.

**Returns:** results[] today's Shell Shocker deal items (title, price, url)

### POST /newegg/v1/categories — 1 credit
top-level store/category nodes from homepage RolloverMenu

**Parameters:** none

**Returns:** categories[] {store_id, name, store_type, url} top-level stores

### POST /newegg/v1/filters — 1 credit
search facets, department navigation, and sort options for a query

**Parameters:**
- `query` (string, required) — Keyword to get facets/sort options for.
- `page` (integer, optional, default 1) — Result page (1-based). Page forward with meta.next_page.

**Returns:** facets[], navigation[], sort_options[] {value, name}, total_products

**Example request body:**
```json
{
  "query": "ssd"
}
```

### POST /newegg/v1/similar — 1 credit
related product cards from a product detail page

**Parameters:**
- `item_id` (string, required) — Newegg item id (the N82E... code in a /p/ URL).
- `url` (string, optional) — Full Newegg product URL (overrides item_id when both are given).
- `limit` (integer, optional, default 12) — Max related items (1-36, default 12).

**Returns:** results[] related products (item_id, title, price, image, url)

**Example request body:**
```json
{
  "item_id": "N82E16820156412"
}
```

### POST /newegg/v1/category_tree — 1 credit
nested category navigation tree from a Newegg store landing page

**Parameters:**
- `store_id` (integer, optional, default 1) — Newegg store id (default 1; from the categories action).
- `store_slug` (string, optional) — Optional store slug for the landing page.

**Returns:** tree[] nested category nodes {name, store_id, subcategory_id, subcategory_slug, url}, store_id

### POST /newegg/v1/variants — 1 credit
Product family/variant options from the PDP — size/capacity/colour family members, package bundles, and any combo-deal promotion

**Parameters:**
- `item_id` (string, required) — Newegg item id (the N82E... code in a /p/ URL).
- `url` (string, optional) — Full Newegg product URL (overrides item_id when both are given).

**Returns:** variants[] {product_number, title, price, in_stock, type} + combo_deal{} when present

**Example request body:**
```json
{
  "item_id": "N82E16820156412"
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=newegg
- Human docs page: https://reefapi.com/docs/newegg
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt