{ "openapi": "3.0.1", "info": { "title": "Amazon Product Details Agent", "description": "Turn Amazon ASINs or product URLs into structured product data for Amazon.com, Amazon.co.uk, and Amazon.de. Title, brand, BSR, ratings, images, prices, and variants. Only successful checks are billed.", "version": "0.1", "x-build-id": "uofRCfiOwJ0hhGDeL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/buzzidata~amazon-product-details-agent/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-buzzidata-amazon-product-details-agent", "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/buzzidata~amazon-product-details-agent/runs": { "post": { "operationId": "runs-sync-buzzidata-amazon-product-details-agent", "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/buzzidata~amazon-product-details-agent/run-sync": { "post": { "operationId": "run-sync-buzzidata-amazon-product-details-agent", "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": { "asins": { "title": "ASINs", "type": "array", "description": "Amazon ASINs to check (10-character identifiers). Duplicate ASINs are fetched once per marketplace.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Amazon product URLs. The Actor extracts the ASIN from /dp/, /gp/product/, /gp/aw/d/, or an asin= query parameter. A URL on amazon.co.uk or amazon.de overrides the marketplace field for that item.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "com", "co.uk", "de" ], "type": "string", "description": "Primary Amazon marketplace for ASINs that do not already include a storefront in the URL.", "default": "com" }, "postalCode": { "title": "Postal / ZIP code", "type": "string", "description": "Deliver-to postal code for availability and shipping context. Default 92618 is Irvine, CA, used as the example US ZIP. Accepts US ZIP codes (for example 92618) and UK or DE postcodes. In JSON input, zipCode is treated the same as postalCode.", "default": "92618" }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Parse and write dataset items without charging for successful product checks. Use this to test parsing before you run billed checks.", "default": false }, "proxyGroup": { "title": "Apify Proxy group", "enum": [ "UNBLOCKER", "RESIDENTIAL" ], "type": "string", "description": "Apify Proxy product to use. UNBLOCKER is the recommended production default for Amazon.com. Choose RESIDENTIAL when you need a sticky IP so deliver-to location stays set. Unblocker is billed in Unblocker units. Residential is billed per GB.", "default": "UNBLOCKER" }, "proxyCountry": { "title": "Proxy country", "enum": [ "US", "GB", "DE" ], "type": "string", "description": "Proxy country when proxyGroup is RESIDENTIAL. Amazon.com requires US residential IPs. Default US. Ignored for UNBLOCKER, because country targeting shrinks the bypass pool.", "default": "US" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy widget. The production default is proxyGroup=UNBLOCKER, which overrides this widget. Pick RESIDENTIAL on proxyGroup as a sticky-IP fallback. Datacenter and AUTO IPs are frequently blocked. Set useApifyProxy=false only for local debugging.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "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 } } } } } } } } } }