{
"openapi": "3.0.1",
"info": {
"title": "Newegg Scraper - Products, Prices, Specs & Reviews",
"description": "Scrape Newegg by keyword, category or URL: live price, discount %, stock, full specifications, ratings, reviews, marketplace seller leads & price/stock monitoring across the US & Canada.",
"version": "0.1",
"x-build-id": "WhUjqGBPSgyuAPgZC"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~newegg-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-newegg-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/scrapesage~newegg-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-newegg-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/scrapesage~newegg-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-newegg-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": {
"searchTerms": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to search Newegg for, e.g. rtx 4070, ssd, gaming laptop, mechanical keyboard. Each keyword is scraped as its own product feed (up to 96 products per page). Leave empty if you only use Start URLs / Item numbers.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Newegg URLs to scrape directly: product pages (/<slug>/p/<ItemNumber>), search/category/store/deals listing pages (/p/pl?d=…, /Store/…, brand or seller storefronts). Used in addition to the keyword search.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"itemNumbers": {
"title": "Item numbers (direct detail)",
"type": "array",
"description": "Newegg item numbers to fetch full product detail for directly, e.g. N82E16814126761. Equivalent to pasting their product URLs.",
"items": {
"type": "string"
}
},
"site": {
"title": "Newegg site",
"enum": [
"us",
"ca"
],
"type": "string",
"description": "Which Newegg storefront to scrape. us = Newegg.com (USD), ca = Newegg.ca (CAD). Start URLs override this per-URL by their domain.",
"default": "us"
},
"sort": {
"title": "Sort order",
"enum": [
"default",
"priceAsc",
"priceDesc",
"bestRating"
],
"type": "string",
"description": "How Newegg orders the keyword search results.",
"default": "default"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose price (in the site currency) is at least this much."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only keep products whose price (in the site currency) is at most this much."
},
"fourStarPlus": {
"title": "4 stars & up only",
"type": "boolean",
"description": "Only keep products with an average rating of 4.0 stars or higher (drops new / low-rated items).",
"default": false
},
"inStockOnly": {
"title": "In stock only",
"type": "boolean",
"description": "Drop products that are out of stock (uses live stock from the realtime price/stock check).",
"default": false
},
"maxProducts": {
"title": "Max products",
"minimum": 1,
"type": "integer",
"description": "Maximum number of product records to scrape across all searches/URLs. Newegg search returns up to 96 products per page.",
"default": 100
},
"maxPagesPerSearch": {
"title": "Max pages per search",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "How many search result pages to page through per keyword/listing (up to 96 products each).",
"default": 10
},
"includeProductDetails": {
"title": "Include full product detail",
"type": "boolean",
"description": "Open each product to add the full specifications table, description, all images, MPN/GTIN/model, live price & stock (and the 30-day lowest price), marketplace seller, warranty & promotions. Turn OFF for a faster/cheaper discovery run (title, URL, item number, card price, rating, review count, image only). Adds one request per product.",
"default": true
},
"includeReviews": {
"title": "Include buyer reviews",
"type": "boolean",
"description": "Pull the buyer reviews embedded on each product page (rating, title, text, author, date) as separate review records. Adds no extra request when product detail is on.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Max reviews per product",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Maximum number of buyer reviews to pull per product when reviews are enabled.",
"default": 20
},
"includeSellerLeads": {
"title": "Include marketplace seller leads",
"type": "boolean",
"description": "Output one deduplicated lead record per third-party Newegg Marketplace seller seen in the run (store name, rating, review count, lifetime orders, top-rated flag, product count, sample products, categories & a 0–100 lead score). First-party Newegg items are not leads.",
"default": false
},
"deduplicateProducts": {
"title": "Deduplicate products",
"type": "boolean",
"description": "Drop duplicate products that appear in more than one search/page in the same run.",
"default": true
},
"monitorMode": {
"title": "Monitor mode (only new / changed)",
"type": "boolean",
"description": "Remember products across runs in a named key-value store and emit ONLY products that are new OR whose price/stock changed since the last run (each carries a changeType: new / price_drop / price_rise / restocked / out_of_stock). Pair with Apify Schedules for price-drop & restock alerts — it complements the scheduler (the schedule starts the run; monitor mode dedupes against prior runs). Needs product detail ON to compare live prices.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the monitor's memory store so you can run several independent monitors (e.g. one per keyword). Reuse the same key to keep tracking the same feed.",
"default": "default"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "Parallel page/request fetches. Keep moderate (3–5) so Newegg's anti-bot doesn't serve the challenge page.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. Newegg serves cleanly to Apify datacenter proxies; keep the default. Switch to RESIDENTIAL only if you see repeated blocked / challenge warnings.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}