{ "openapi": "3.0.1", "info": { "title": "Amazon ASIN Lookup — Bulk Product Details", "description": "Bulk Amazon ASIN lookup — one or thousands of ASINs per run, one clean detail row each: title, price, byline + brand-store links, photo gallery, badges (Best Seller, Amazon's Choice, Climate Pledge Friendly, Prime), rating, availability. 19 marketplaces. Failed lookups never charged.", "version": "1.0", "x-build-id": "4BXLxjcQN3xsXvh4y" }, "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 and invalid IDs are skipped automatically. 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 ASIN shown here.", "default": "B07ZPKBL9V" }, "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" } } }, "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 } } } } } } } } } }