{ "openapi": "3.0.1", "info": { "title": "Amazon Category Product Scraper", "description": "Powerful Amazon category product scraper that automatically extracts up to 10,000 products from specific categories. Includes comprehensive filtering, multiple countries support, and detailed product information with automatic rate limit handling.", "version": "0.0", "x-build-id": "EdJUH97k9HcXse9bs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/powerai~amazon-category-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-powerai-amazon-category-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/powerai~amazon-category-product-scraper/runs": { "post": { "operationId": "runs-sync-powerai-amazon-category-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/powerai~amazon-category-product-scraper/run-sync": { "post": { "operationId": "run-sync-powerai-amazon-category-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", "required": [ "category_id" ], "properties": { "category_id": { "title": "Category ID", "type": "string", "description": "Amazon category ID to filter results. The category ID can be obtained from the Amazon category results URL, for example: https://amazon.com/s?node=2858778013 - the Amazon Category ID is 2858778013. Multiple category values can be separated by comma (e.g. categoryId1,categoryId2).", "default": "281407" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to collect across pages.", "default": 20 }, "country": { "title": "Country", "enum": [ "US", "AU", "BR", "CA", "CN", "FR", "DE", "IN", "IT", "MX", "NL", "SG", "ES", "TR", "AE", "GB", "JP", "SA", "PL", "SE", "BE", "EG" ], "type": "string", "description": "Amazon marketplace (country). Choose GB for the United Kingdom.", "default": "US" }, "sort_by": { "title": "Sort By", "enum": [ "RELEVANCE", "LOWEST_PRICE", "HIGHEST_PRICE", "REVIEWS", "NEWEST", "BEST_SELLERS" ], "type": "string", "description": "Sort results by criteria", "default": "RELEVANCE" }, "min_price": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum price filter. Only return product offers with price greater than a certain value. Specified in the currency of the selected country. For example, in case country=US, a value of 105.34 means $105.34." }, "max_price": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum price filter. Only return product offers with price lower than a certain value. Specified in the currency of the selected country. For example, in case country=US, a value of 105.34 means $105.34." }, "product_condition": { "title": "Product Condition", "enum": [ "ALL", "NEW", "USED", "RENEWED", "COLLECTIBLE" ], "type": "string", "description": "Filter by product condition", "default": "ALL" }, "brand": { "title": "Brand", "type": "string", "description": "Filter by specific brand. Only return products of a specific brand. Multiple brands can be specified as a comma (,) separated list. The brand values can be seen from Amazon's search left filters panel.Examples: SAMSUNG,Google" }, "is_prime": { "title": "Prime Only", "type": "boolean", "description": "Show only Prime eligible products", "default": false }, "deals_and_discounts": { "title": "Deals and Discounts", "enum": [ "NONE", "ALL_DISCOUNTS", "TODAYS_DEALS" ], "type": "string", "description": "Filter by deals and discounts", "default": "NONE" }, "four_stars_and_up": { "title": "4 Stars and Up", "type": "boolean", "description": "Show only products with 4 stars or higher", "default": false }, "language": { "title": "Language", "enum": [ "en_US", "es_US", "en_AU", "pt_BR", "en_CA", "fr_CA", "fr_FR", "en_GB", "de_DE", "cs_CZ", "nl_NL", "pl_PL", "tr_TR", "da_DK", "en_IN", "hi_IN", "ta_IN", "te_IN", "kn_IN", "ml_IN", "bn_IN", "mr_IN", "it_IT", "es_MX", "en_SG", "es_ES", "pt_PT", "ar_AE", "ja_JP", "zh_CN", "sv_SE", "fr_BE" ], "type": "string", "description": "Language code for results", "default": "en_US" }, "additional_filters": { "title": "Additional Filters", "type": "string", "description": "Additional filtering criteria" }, "fields": { "title": "Fields", "type": "string", "description": "Specific fields to return in results" } } }, "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 } } } } } } } } } }