{ "openapi": "3.0.1", "info": { "title": "Amazon ASIN Lookup โ€” Bulk Product Details", "description": "Look up one or thousands of Amazon ASINs per run and get one row each: title, price, delivery price for any zip code, byline and brand-store links, photos, badges (Best Seller, Amazon's Choice, Prime, Climate Pledge Friendly), rating and availability. 19 marketplaces. Failed lookups aren't charged.", "version": "1.0", "x-build-id": "teejUc4ox7DJRKp5O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~amazon-asin-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-amazon-asin-lookup", "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/sian.agency~amazon-asin-lookup/runs": { "post": { "operationId": "runs-sync-sian.agency-amazon-asin-lookup", "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/sian.agency~amazon-asin-lookup/run-sync": { "post": { "operationId": "run-sync-sian.agency-amazon-asin-lookup", "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": { "asin": { "title": "๐Ÿ“ฆ Single ASIN", "pattern": "^[A-Z0-9]{10}$", "type": "string", "description": "One Amazon ASIN โ€” exactly 10 alphanumeric characters (e.g. B07ZPKBL9V). Use this field for a single-product lookup. Leave blank if you are using the Bulk ASINs field below." }, "bulkAsins": { "title": "๐Ÿ“‹ Bulk ASINs (paste a list)", "type": "string", "description": "Paste many ASINs at once โ€” separated by commas, spaces, semicolons, or newlines. Duplicates are merged; anything that is not a 10-character ASIN comes back as a free error row so you can fix it. Each valid ASIN becomes one billed lookup row.\n\nโ„น๏ธ Used only when you have not supplied ASINs through any other field. If you fill in Single ASIN, ASIN list, or ASIN file URL, those win and this box is ignored โ€” so you are never charged for the sample ASINs shown here." }, "asins": { "title": "๐Ÿงพ ASINs (array)", "type": "array", "description": "Array of ASINs โ€” useful when calling the actor from code or a workflow. Same dedup + validation as Bulk ASINs.", "items": { "type": "string", "pattern": "^[A-Z0-9]{10}$" } }, "asinsFileUrl": { "title": "๐Ÿ”— ASINs file URL (optional)", "type": "string", "description": "URL to a remote text file containing ASINs separated by commas, spaces, or newlines. The actor fetches and parses it on start. Useful for very large lookup batches." }, "country": { "title": "๐ŸŒ Country", "enum": [ "US", "CA", "UK", "DE", "FR", "IT", "ES", "JP", "AU", "IN", "BR", "MX", "NL", "SE", "TR", "PL", "AE", "SA", "SG" ], "type": "string", "description": "Amazon marketplace country code โ€” controls which regional Amazon domain is used (US โ†’ amazon.com, UK โ†’ amazon.co.uk, etc.).", "default": "US" }, "deliveryZipcode": { "title": "๐Ÿ“ Delivery zip / postal code (optional)", "maxLength": 12, "type": "string", "description": "Optional. Shows prices, availability, delivery dates and shipping costs as if delivering to this zip or postal code โ€” the same as Amazon's \"Deliver to\" box. Use a code that exists in the selected country, e.g. 10001 (US) or DE1 2NP (UK). Leave blank to use the marketplace's default location." } } }, "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 } } } } } } } } } }