# Newegg Product Scraper (`sian.agency/newegg-product-scraper`) Actor

Scrape Newegg products — price, ratings, images, specs & seller info. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/newegg-product-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.75 / 1,000 overview products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Newegg Product Scraper — Prices, Specs & Reviews 🥚

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Product%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) [![Walmart Product Scraper](https://img.shields.io/badge/Store-Walmart%20Product%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) [![Google Shopping Price Tracker](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Tracker-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian)

#### 🎉 Pull live Newegg prices, ratings, specs and seller info — by keyword or category, no code
##### Built for PC builders, e-commerce sellers, price analysts and electronics brands who need fresh Newegg product data on demand

---

### 📋 Overview

**Need clean Newegg data without copy-pasting product pages all day?** This scraper turns any Newegg search or category into a tidy, structured spreadsheet of products — complete with prices, ratings, images, specifications and seller details — ready to download as JSON, CSV or Excel.

**Why thousands of professionals choose us:**
- ✅ **Complete product data**: price, original price, MAP, instant rebates, ratings, review counts, images, stock, seller and full specs
- ⚡ **Fast keyword & category search**: ~40+ products per page, paginated automatically until you hit your limit
- 🎯 **Full specification sheets**: switch to Detail mode for the complete specs table, UPC, manufacturer part number and category breadcrumbs
- 💰 **Pay-per-result pricing**: you're only charged for the products you actually receive — no wasted spend
- 💎 **Native sorting**: order results by featured, price, best-selling, best rating or most reviews — exactly like the site
- ✨ **NEW**: two modes — fast Overview for catalog sweeps, rich Detail for complete spec sheets

---

### ✨ Features

- 🔎 **Keyword & Category Search**: scrape any Newegg search term or category listing
- ⚡ **Overview Mode**: price, ratings, images, brand/model, seller and stock — the fast, cheap path
- 🔬 **Detail Mode**: everything in Overview PLUS the full specifications table, UPC, part number and breadcrumbs
- 💲 **Rich Pricing**: current price, original/list price, MAP, instant rebates and shipping cost
- ⭐ **Ratings & Reviews**: average rating and total review count for every product
- 📸 **All Product Images**: every hi-res image URL, hero image first
- 🏪 **Seller & Stock**: marketplace seller name, in-stock flag and ships-from country
- 🔃 **Native Sorting**: featured, price low/high, best-selling, best rating, most reviews
- 📦 **Clean Exports**: download as JSON, CSV or Excel — no formatting cleanup needed

---

### 🎬 Quick Start

Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Newegg products you can download as JSON or CSV. No setup, no code.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~newegg-product-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"keywords": ["rtx 4070"], "scrapeMode": "overview", "maxResults": 50}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Enter your searches

Type one or more Newegg search keywords (e.g. `rtx 4070`, `ddr5 32gb`, `nvme ssd 2tb`) — one per line.

#### Step 2: Pick a mode

Choose **Overview** for a fast catalog sweep, or **Detail** for the full specification sheet on every product.

#### Step 3: Run and download

Click **Start**, then export your results as JSON, CSV or Excel.

**That's it! In about a minute, you'll have:**

- A clean table of Newegg products with prices and ratings
- Images, seller info and stock status for each item
- Full specification sheets (in Detail mode)

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| keywords | array | No | Newegg search terms, one per item (e.g. `rtx 4070`) |
| navValues | array | No | Advanced — Newegg category `N=` value from a category URL |
| scrapeMode | string | No | `overview` (fast) or `detail` (full specs) — default `overview` |
| sort | string | No | `featured`, `price_low`, `price_high`, `best_selling`, `best_rating`, `most_reviews` |
| maxResults | integer | No | Max products across all searches (FREE: 25, PAID: unlimited) |

**Example:**

```json
{
  "keywords": ["rtx 4070", "ddr5 32gb"],
  "scrapeMode": "detail",
  "sort": "best_selling",
  "maxResults": 100
}
```

**Category sweep:**

```json
{
  "navValues": ["100007709"],
  "scrapeMode": "overview",
  "maxResults": 200
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **35+ fields** including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Full product name |
| brand | string | Manufacturer / brand |
| model\_number | string | Manufacturer model number |
| part\_number | string | Manufacturer part number (Detail) |
| upc | string | Universal Product Code (Detail) |
| price | number | Current final price |
| original\_price | number | List/was price before discount |
| instant\_rebate | number | Instant rebate amount |
| rating | number | Average customer rating (0–5) |
| review\_count | integer | Total number of reviews |
| in\_stock | boolean | Whether the product is in stock |
| seller\_name | string | Marketplace seller (empty when sold by Newegg) |
| category | string | Top-level product category |
| specs | object | Full key-value specifications table (Detail) |
| images | array | All product image URLs |
| url | string | Direct link to the product page |

**Example:**

```json
{
  "item_id": "14-126-761",
  "productTitle": "ASUS PRIME GeForce RTX 5070 12GB GDDR7 Graphics Card",
  "brand": "ASUS",
  "model_number": "PRIME-RTX5070-12G",
  "price": 641.99,
  "original_price": 710.49,
  "instant_rebate": 68.5,
  "rating": 4.5,
  "review_count": 170,
  "in_stock": true,
  "category": "Components",
  "subcategory": "GPUs / Video Graphics Cards",
  "images": ["https://c1.neweggimages.com/ProductImageOriginal/14-126-761-01.png"],
  "url": "https://www.newegg.com/asus-prime-rtx5070-12g/p/N82E16814126761"
}
```

***

### 💼 Use Cases & Examples

#### 1. Price & Promo Monitoring

**Retailers and resellers tracking competitor pricing on PC parts and electronics.**

**Input:** A list of product keywords (e.g. `rtx 4070`, `9800x3d`)
**Output:** Current price, original price, rebates and MAP for every match
**Use:** Spot price drops, undercut competitors, time your buys

#### 2. PC-Part Catalog Research

**System builders and storefronts assembling component catalogs.**

**Input:** Category nav values or broad keywords
**Output:** Full product lists with specs, images and stock
**Use:** Build comparison tables and buying guides without manual entry

#### 3. Competitive Pricing Intelligence

**Brands and analysts benchmarking electronics across the market.**

**Input:** Brand or product-line keywords
**Output:** Structured pricing and rating data, refreshed on demand
**Use:** Feed dashboards and BI tools with fresh market data

#### 4. Product Feed & Spec Extraction

**E-commerce teams populating product feeds.**

**Input:** Keywords in Detail mode
**Output:** Full specification tables, UPC and part numbers
**Use:** Enrich product feeds with accurate, structured specs

#### 5. Stock & Availability Checks

**Buyers and procurement teams watching for restocks.**

**Input:** Specific product keywords
**Output:** In-stock flags, seller and shipping info
**Use:** Trigger alerts when sought-after parts come back in stock

#### 6. Market & Demand Research

**Analysts studying electronics pricing and assortment trends.**

**Input:** Category sweeps across multiple keywords
**Output:** Large structured datasets ready for analysis
**Use:** Track assortment breadth, pricing bands and rating distributions

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/newegg-product-scraper').call({
  keywords: ['rtx 4070'],
  scrapeMode: 'overview',
  maxResults: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/newegg-product-scraper').call(
    run_input={'keywords': ['rtx 4070'], 'scrapeMode': 'overview', 'maxResults': 50}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~newegg-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords": ["rtx 4070"], "scrapeMode": "overview"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule or webhook
2. **HTTP Request**: Call the actor API
3. **Process**: Handle JSON results
4. **Action**: Save to a sheet, notify a channel, or update a dashboard

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 products** per run — full feature access, same quality
- No credit card required
- Perfect for testing and small projects

#### PAID Tier (Production Ready)

- **Unlimited** products per run
- Faster processing, no delays
- Pay-per-result: only charged for successful results

💰 **Transparent pay-per-result pricing** — a cheap, high-volume Overview event and a premium Detail event for full spec sheets.

🔗 [View current pricing](https://apify.com/sian.agency/newegg-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many products can I scrape?**
A: FREE tier: 25 per run. PAID tier: unlimited.

**Q: What's the difference between Overview and Detail mode?**
A: Overview returns search-result data (price, ratings, images, seller, stock). Detail adds the full specifications table, UPC, manufacturer part number and category breadcrumbs from each product page.

**Q: Can I scrape a whole category?**
A: Yes — paste the category's `N=` value into the navValues field for a category-level sweep.

**Q: What output formats are available?**
A: JSON, CSV and Excel — export directly from the Apify dataset.

**Q: Do I need an account or API key for Newegg?**
A: No — just enter your keywords and run.

**Q: Is this legal?**
A: Yes — we only extract publicly available data. See the legal section below.

***

### 🐛 Troubleshooting

**No results returned**

- Check your keyword spelling and try a broader term
- Some very niche keywords return few or no products — try a category sweep instead

**Fewer results than expected**

- FREE tier caps at 25 products per run — upgrade to PAID for unlimited
- Raise `maxResults` if you set it low

**Missing specs**

- Specifications, UPC and part numbers are only populated in **Detail** mode

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

> **Trademark notice:** Newegg® is a trademark of Newegg Inc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Newegg. It is provided solely to help users collect publicly available product information.

***

### 🤝 Support

[![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi)

**Join our active support community**

- For issues or questions, open an issue in the actor's repository
- Check [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `keywords` (type: `array`):

🔍 **KEYWORD SEARCH:** Free-text Newegg searches — exactly what you'd type into the site's search bar.

📝 **EXAMPLES:** `rtx 4070` · `ddr5 32gb` · `nvme ssd 2tb` · `gaming laptop`

💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.

🖊️ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line).

✅ **IMPORTANT:** Provide either keywords OR category nav values (at least one is needed to have something to scrape).

## `navValues` (type: `array`):

🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Newegg category instead of a keyword search.

🔧 **HOW TO GET IT:** Open any Newegg category or filtered results page and copy the `N=` value from the URL (e.g. the part after `N=` in `newegg.com/p/pl?N=100007709`). Paste just that value here.

💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.

🖊️ **BULK EDIT:** Add one nav value per line to sweep multiple categories in a single run.

## `scrapeMode` (type: `string`):

⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.

⚡ **Overview (fast):** Search results only — price, ratings, images, brand/model, seller and stock. Fastest and cheapest path.

🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, UPC, manufacturer part number and category breadcrumbs scraped from each product page.

💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.

## `sort` (type: `string`):

🔃 **RESULT ORDERING:** Order search results using Newegg's own native sort options — so you get the same ranking real shoppers see.

⭐ **Featured** is Newegg's default ranking · 💲 **Price** sorts ascending or descending · 🔥 **Best selling** surfaces the most popular products · ⭐ **Best rating** leads with the highest-reviewed items · 💬 **Most reviews** prioritizes the most-reviewed products.

## `maxResults` (type: `integer`):

🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.

🎁 **TIER-BASED LIMITS:**

- **FREE users:** Up to 25 products per run
- **PAID users:** Unlimited — scrape entire catalogs in a single run

💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.

## Actor input object example

```json
{
  "keywords": [
    "rtx 4070"
  ],
  "scrapeMode": "overview",
  "sort": "featured",
  "maxResults": 100
}
```

# Actor output Schema

## `neweggProducts` (type: `string`):

Scraped Newegg products with prices, promotions, ratings, images, specs and seller info.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "rtx 4070"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/newegg-product-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["rtx 4070"] }

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/newegg-product-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "rtx 4070"
  ]
}' |
apify call sian.agency/newegg-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/newegg-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Newegg Product Scraper",
        "description": "Scrape Newegg products — price, ratings, images, specs & seller info. Keyword or category search, full detail enrichment, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "iWZWR0D7EfVrAp1cY"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~newegg-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-newegg-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/sian.agency~newegg-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-newegg-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/sian.agency~newegg-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-newegg-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "keywords": {
                        "title": "🔍 Search Keywords",
                        "type": "array",
                        "description": "🔍 **KEYWORD SEARCH:** Free-text Newegg searches — exactly what you'd type into the site's search bar.\n\n📝 **EXAMPLES:** `rtx 4070` · `ddr5 32gb` · `nvme ssd 2tb` · `gaming laptop`\n\n💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.\n\n🖊️ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\n✅ **IMPORTANT:** Provide either keywords OR category nav values (at least one is needed to have something to scrape).",
                        "default": [
                            "rtx 4070"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "navValues": {
                        "title": "🧭 Category Nav Values (Advanced)",
                        "type": "array",
                        "description": "🧭 **CATEGORY BROWSING (Advanced):** Scrape a whole Newegg category instead of a keyword search.\n\n🔧 **HOW TO GET IT:** Open any Newegg category or filtered results page and copy the `N=` value from the URL (e.g. the part after `N=` in `newegg.com/p/pl?N=100007709`). Paste just that value here.\n\n💡 **TIP:** Leave this empty if you're only using keywords — it's purely an advanced alternative for category-level harvesting.\n\n🖊️ **BULK EDIT:** Add one nav value per line to sweep multiple categories in a single run.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "scrapeMode": {
                        "title": "⚙️ Scrape Mode",
                        "enum": [
                            "overview",
                            "detail"
                        ],
                        "type": "string",
                        "description": "⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\n⚡ **Overview (fast):** Search results only — price, ratings, images, brand/model, seller and stock. Fastest and cheapest path.\n\n🔬 **Detail (enriched specs):** Everything in Overview PLUS the full specifications table, UPC, manufacturer part number and category breadcrumbs scraped from each product page.\n\n💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need the complete spec sheet for feeds or comparisons.",
                        "default": "overview"
                    },
                    "sort": {
                        "title": "🔃 Sort Order",
                        "enum": [
                            "featured",
                            "price_low",
                            "price_high",
                            "best_selling",
                            "best_rating",
                            "most_reviews"
                        ],
                        "type": "string",
                        "description": "🔃 **RESULT ORDERING:** Order search results using Newegg's own native sort options — so you get the same ranking real shoppers see.\n\n⭐ **Featured** is Newegg's default ranking · 💲 **Price** sorts ascending or descending · 🔥 **Best selling** surfaces the most popular products · ⭐ **Best rating** leads with the highest-reviewed items · 💬 **Most reviews** prioritizes the most-reviewed products.",
                        "default": "featured"
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "🔢 **RESULT CAP:** Maximum number of products to return across all keywords and categories combined.\n\n🎁 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited — scrape entire catalogs in a single run\n\n💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.",
                        "default": 100
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
