{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper 🛒 $0.9/1k", "description": "$0.9/1k 💰 | Fast ⚡️ | Quick Support 🚀 | Scrape Amazon search and product pages; get prices and availability, brands and product facts, ratings and review counts, and high-resolution product images. Export JSON or CSV for price monitoring and product research.", "version": "1.4", "x-build-id": "cEGxrOoLSTwslEuYE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/123webdata~amazon-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-123webdata-amazon-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/123webdata~amazon-product-scraper/runs": { "post": { "operationId": "runs-sync-123webdata-amazon-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/123webdata~amazon-product-scraper/run-sync": { "post": { "operationId": "run-sync-123webdata-amazon-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": { "productUrls": { "title": "Product URLs", "type": "array", "description": "Add one or more product page URLs to scrape. Example product URLs:\n\n- https://www.amazon.com/dp/B0D1XD1ZV3", "default": [], "items": { "type": "string" } }, "categoryUrls": { "title": "List URLs", "type": "array", "description": "Add one or more List URLs to scrape.\n\nSupported page types with examples:\n\n- Search page: https://www.amazon.com/s?k=wireless+headphones\n- Filtered result page: https://www.amazon.com/s?k=wireless+headphones&rh=p_72%3A1248879011\n- Brand page: https://www.amazon.com/s?k=wireless+headphones&rh=p_89%3ASony\n\nLeave blank if using direct product URLs instead.\n\nThe `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.", "default": [], "items": { "type": "string" } }, "maxResultsPerScrape": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of product records to save.", "default": 20 }, "usePagination": { "title": "Use pagination", "type": "boolean", "description": "If this option is enabled and a List URL has more than one page, the Actor continues through the following pages until it reaches the Maximum results limit. If the option is disabled, the Actor only scrapes the first page of each List URL.", "default": true }, "scrapeProductDetails": { "title": "Include product details", "type": "boolean", "description": "If this option is enabled, the Actor visits each product page and adds the full product details to every record. If it is disabled, the Actor returns one list-level result record per product card.\n\nFields that are always included:\n\n- `url`\n- `product_id`\n- `sku`\n- `name`\n- `price`\n- `regular_price`\n- `currency`\n- `main_image`\n- `images`\n- `rating_value`\n- `review_count`\n- `badges`\n- `coupon_price`\n- `sponsored`\n- `canonical_url`\n- `scraped_at`\n\nFields that are only added when this option is enabled (set to true), and not added when it is disabled:\n\n- `in_stock`\n- `mpn`\n- `brand`\n- `category`\n- `breadcrumbs`\n- `breadcrumb_urls`\n- `description`\n- `description_html`\n- `color`\n- `weight`\n- `features`\n- `attributes`\n- `seller_name`\n- `seller_url`", "default": 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 }, "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 } } } } } } } } } }