{
  "openapi": "3.0.1",
  "info": {
    "title": "Amazon Product Details Scraper | Amazon ASIN Lookup",
    "description": "Scrape Amazon product details by ASIN or link at $1.50 per 1,000 products: price, list price, buy-box seller, stock, rating histogram, Best Sellers Rank, bullets, images and variant ASINs on amazon.com, .ca, .co.uk and .de. No login.",
    "version": "0.1",
    "x-build-id": "rIOf1K5RxesZab86x"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aurelix~amazon-product-details-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aurelix-amazon-product-details-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/aurelix~amazon-product-details-scraper/runs": {
      "post": {
        "operationId": "runs-sync-aurelix-amazon-product-details-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/aurelix~amazon-product-details-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-aurelix-amazon-product-details-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": [
          "products"
        ],
        "properties": {
          "products": {
            "title": "ASINs or product links",
            "maxItems": 1000,
            "type": "array",
            "description": "Amazon ASINs, e.g. 'B005EPRFKO', or product links, e.g. 'https://www.amazon.co.uk/dp/B08HLGKP9J'. Links keep their own marketplace (amazon.com, .ca, .co.uk, .de); bare ASINs use the marketplace below. Up to 1,000 per run.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "marketplace": {
            "title": "Marketplace for bare ASINs",
            "enum": [
              "com",
              "ca",
              "co.uk",
              "de"
            ],
            "type": "string",
            "description": "Which Amazon a bare ASIN is read from. Product links always use their own marketplace.",
            "default": "com"
          },
          "includeVariants": {
            "title": "Include variants",
            "type": "boolean",
            "description": "Also read every variant (size, color, style ...) of each product as its own row with its own price, stock and buy box, up to 'Variants per product'. Each variant is charged as a product. Off: each row still lists its variant ASINs and their attributes for free.",
            "default": false
          },
          "maxVariantsPerProduct": {
            "title": "Variants per product",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Most variants read per product when 'Include variants' is on, e.g. 20. Clothing can have hundreds of size/color combinations; the full list of variant ASINs is always in the 'variants' field.",
            "default": 20
          },
          "onlyChanges": {
            "title": "Only changed products",
            "type": "boolean",
            "description": "Return only products that are new to your list or whose price, buy box, stock or Best Sellers Rank changed since your previous run ('changedFields' and 'previous' show what moved). The first run returns everything and saves the baseline. Unchanged products are not returned and cost $0.0006 each (product-checked) instead of the product price.",
            "default": false
          },
          "watchFields": {
            "title": "Changes to watch",
            "type": "array",
            "description": "Which changes count in 'Only changed products' mode. Best Sellers Rank moves often; leave it out to be told only about price, buy-box and stock moves.",
            "items": {
              "type": "string",
              "enum": [
                "price",
                "buyBox",
                "stock",
                "bsr"
              ],
              "enumTitles": [
                "Price",
                "Buy box (seller and price)",
                "Stock (availability)",
                "Best Sellers Rank (top category)"
              ]
            },
            "default": [
              "price",
              "buyBox",
              "stock",
              "bsr"
            ]
          },
          "stateKey": {
            "title": "Tracking name (optional)",
            "type": "string",
            "description": "Name for the 'previous run' memory used by 'Only changed products', e.g. 'my-competitors-daily'. Leave empty and the memory follows this exact product list: change the list and the next run starts a new baseline (every product returned and charged). Set a name to keep one memory while you add or remove ASINs."
          },
          "residentialFallback": {
            "title": "Residential fallback (paid add-on)",
            "type": "boolean",
            "description": "Off by default. When on, a product Amazon refuses on 8 datacenter sessions (amazon.com, amazon.ca) is retried on up to 3 residential proxy sessions in that country, and amazon.co.uk and amazon.de are read only over UK and German residential IPs (no datacenter attempt), so their prices include the local VAT. amazon.co.uk and amazon.de need this option or 'Always full pages'; without one they get a free row and nothing is requested. The residential fee ($0.012) applies to every request sent over residential, even if Amazon refuses it. Challenges are never solved.",
            "default": false
          },
          "fullPage": {
            "title": "Always full pages (paid add-on)",
            "type": "boolean",
            "description": "Off by default. When on, every product is read on its /dp page over residential proxies in the marketplace's country, so Best Sellers Rank, the rating histogram and the description are present whenever Amazon shows them (in our tests every residential read was a full page). The residential fee ($0.012) applies to every request sent over residential, even if Amazon refuses it. Without it, many rows come from Amazon's compact page, which has none of those fields.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify Proxy is required; the default datacenter group is used. For residential IPs, use 'Residential fallback' or 'Always full pages' above.",
            "default": {
              "useApifyProxy": true
            }
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL (optional)",
            "type": "string",
            "description": "After each run, post a short digest to Slack: how many products were saved (changed ones only in 'Only changed products' mode) and the top 10 with links, e.g. https://hooks.slack.com/services/T000/B000/XXXX. Nothing is posted when the run saved nothing. Leave empty to skip."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "After each run, POST the same digest as JSON (actor, newOnly, count, items = top 10 results, runUrl, datasetUrl = all results as JSON, text) to any URL, e.g. a Zapier, Make or n8n webhook. Nothing is sent when the run saved nothing. Leave empty to skip."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}