{ "openapi": "3.0.1", "info": { "title": "Newegg Scraper & Price Monitor (price drop alerts)", "description": "Use this Actor when you need Newegg product data or price alerts: price, discount, shipping, rating, reviews, stock and seller from search terms, category or product URLs. Monitor mode returns only new products, price drops and back-in-stock, with webhook alerts.", "version": "0.1", "x-build-id": "6JESDoADdcb4mFa4Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/integrative_cafe_8pc~newegg-products-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-integrative_cafe_8pc-newegg-products-monitor", "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/integrative_cafe_8pc~newegg-products-monitor/runs": { "post": { "operationId": "runs-sync-integrative_cafe_8pc-newegg-products-monitor", "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/integrative_cafe_8pc~newegg-products-monitor/run-sync": { "post": { "operationId": "run-sync-integrative_cafe_8pc-newegg-products-monitor", "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 terms", "type": "array", "description": "Words you would type in the Newegg search box, one per line. Each one returns up to 'Max products per input'. Leave both this and the URLs empty to try the Actor with 'rtx 4070'.", "items": { "type": "string" } }, "startUrls": { "title": "Category, search or product URLs", "type": "array", "description": "Newegg URLs. Category or search pages (like https://www.newegg.com/GPUs-Video-Graphics-Cards/SubCategory/ID-48 or https://www.newegg.com/p/pl?N=100007709) return every product on the list, page by page. Product URLs (https://www.newegg.com/p/N82E16814137814) or bare item numbers (14-137-814) return that one product.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItemsPerInput": { "title": "Max products per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop each search or category after this many products.", "default": 50 }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Keep products Newegg marks as sponsored in search results. They come with isSponsored: true.", "default": true }, "monitorMode": { "title": "Monitor mode (only changes)", "type": "boolean", "description": "Remember every product's price and stock between runs and return only what changed: new products, price drops, back in stock. Schedule the Actor (for example every hour) and keep the same input. The first run returns everything as 'new'.", "default": false }, "notifyOn": { "title": "Report these changes", "type": "array", "description": "Which changes monitor mode returns and sends to the webhook.", "items": { "type": "string", "enum": [ "new", "priceDrop", "backInStock", "priceIncrease", "outOfStock" ], "enumTitles": [ "New product in the list", "Price drop", "Back in stock", "Price increase", "Went out of stock" ] }, "default": [ "new", "priceDrop", "backInStock" ] }, "minPriceDropPercent": { "title": "Minimum price drop (%)", "minimum": 0, "maximum": 99, "type": "integer", "description": "Ignore price drops smaller than this percentage. 0 reports any drop.", "default": 0 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Each run POSTs the delivered products here as JSON (fields content, text and items), in batches of 10. Works with Discord and Slack incoming webhooks, a Telegram bot sendMessage URL with chat_id, Zapier, Make or any endpoint that accepts POST." }, "monitorStoreName": { "title": "Monitor memory name", "type": "string", "description": "Named key-value store in your account where monitor mode keeps the last price and stock. Each different input list gets its own memory inside it.", "default": "newegg-products-monitor" }, "maxConcurrency": { "title": "Parallel inputs", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many inputs are scraped at the same time. Kept low on purpose so Newegg does not block the run.", "default": 2 }, "proxy": { "title": "Proxy", "type": "object", "description": "Newegg is behind Cloudflare and blocks datacenter IPs. Keep US residential proxy for reliable runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }