{ "openapi": "3.0.1", "info": { "title": "Amazon Scraper & API | EveryInfra", "description": "Amazon data via one Actor: search, profile, reviews, bestsellers, sellers. Pay per request, no start fee. First 3 requests free across EveryInfra Actors.", "version": "0.1", "x-build-id": "WOYfPRO1FvbIASvTH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blushing_parachute~everyinfra-amazon-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blushing_parachute-everyinfra-amazon-api", "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/blushing_parachute~everyinfra-amazon-api/runs": { "post": { "operationId": "runs-sync-blushing_parachute-everyinfra-amazon-api", "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/blushing_parachute~everyinfra-amazon-api/run-sync": { "post": { "operationId": "run-sync-blushing_parachute-everyinfra-amazon-api", "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": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "search", "profile", "reviews", "bestsellers", "sellers" ], "type": "string", "description": "What to fetch. Each action uses only the fields listed for it below; other fields are ignored when empty.", "default": "search" }, "keyword": { "title": "keyword", "type": "string", "description": "Used by `search` (required), `bestsellers` (required), `sellers` (required). Specifies the primary search string according to the requested Amazon action. In search, pass the product search terms. In bestsellers, pass a full Amazon bestsellers category URL or a category short name used to build the path. In sellers, pass a product or seller page URL; raw search terms generate a product search page rather than looking up a seller ID directly." }, "domain": { "title": "domain", "type": "string", "description": "Used by `search`, `reviews`. Specifies the Amazon country domain without a scheme or path, such as amazon.com, amazon.co.uk, or amazon.co.jp. The search action uses this value to build search URLs, while reviews uses it to select the target review store. It defaults to amazon.com, but non-US review requests should explicitly supply the domain that matches the product URL. On every store, reviews returns only the featured reviews shown on the product page, usually about a dozen per product, not the full review history." }, "lang": { "title": "lang", "enum": [ "ar", "bn", "cs", "da", "de", "en", "es", "fr", "he", "hi", "ja", "kn", "ko", "ml", "mrta", "nl", "pl", "pt", "sv", "ta", "te", "tr", "zhcn", "zhtw" ], "type": "string", "description": "Used by `search`, `profile`, `bestsellers`, `sellers`. Specifies the page language for supported Amazon endpoints using valid codes such as en or ja. Use zhcn for Simplified Chinese and zhtw for Traditional Chinese instead of a generic zh code. Requests accept only the language codes listed for the action, and selecting a language alters the rendered content rather than changing the target country store." }, "url": { "title": "url", "type": "string", "description": "Used by `profile` (required), `reviews` (required). Specifies an Amazon product URL, such as https://www.amazon.com/dp/. The reviews action extracts a 10-character uppercase alphanumeric ASIN from /dp/, /gp/product/, or /product-reviews/ paths; store homepages are not supported. For this parameter, profile fetches the product details page rather than user profile data." }, "limit": { "title": "limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many results to request for list actions. Defaults and maximums per action: `search` 10 (max 50); `bestsellers` 20 (max 100); `sellers` 10 (max 50). Billing: `search` one event per started block of 10 results; `bestsellers` one event per started block of 20 results; `sellers` one event per started block of 10 results." }, "params": { "title": "params (advanced)", "type": "object", "description": "Optional JSON object with the same fields as above, for API and integration use. Flat fields and params must not disagree." } } }, "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 } } } } } } } } } }