{ "openapi": "3.0.1", "info": { "title": "Amazon Offers & Sellers Scraper: Hijacker & Buy Box Alerts", "description": "Find hijackers and unauthorized sellers on your Amazon listings, e.g. a brand checking its ASINs daily or an agency auditing a client's catalog. About $0.03 per ASIN, no login. Verdict first, then the Buy Box winner and every offer: seller, ID, price, shipping, FBA/FBM, rating, authorized flag.", "version": "1.0", "x-build-id": "CZR0nDReCzzLFZwOq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vant47~amazon-offers-hijackers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vant47-amazon-offers-hijackers", "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/vant47~amazon-offers-hijackers/runs": { "post": { "operationId": "runs-sync-vant47-amazon-offers-hijackers", "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/vant47~amazon-offers-hijackers/run-sync": { "post": { "operationId": "run-sync-vant47-amazon-offers-hijackers", "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 or Amazon product links", "type": "array", "description": "The products to check: ASINs like B0BSHF7WHW or product links like https://www.amazon.com/dp/B0BSHF7WHW. Links from amazon.co.uk, .de, .fr, .it, .es, .ca or .com.au are checked on that marketplace. One result row per ASIN; duplicates are checked once and invalid entries are skipped for free.", "items": { "type": "string" } }, "myBrand": { "title": "Your brand name", "type": "string", "description": "Your brand, e.g. Anker or CeraVe. Sellers whose store name contains it (AnkerDirect, Anker Official) count as authorized; everyone else is flagged unauthorized. Several brands: separate them with commas. Leave empty if you only use seller IDs below." }, "mySellerIds": { "title": "Your authorized sellers (seller IDs or store names)", "type": "array", "description": "Seller IDs (A2L12OQTUXM45G, the seller= part of a store link) or exact store names of you and your approved resellers. Every other seller on your ASINs is reported as unauthorized. With neither a brand nor sellers, the run still lists every seller, the Buy Box and counterfeit-risk signs, but cannot say who is unauthorized.", "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU" ], "type": "string", "description": "Amazon store for plain ASINs. Product links use their own store.", "default": "US" }, "mapPrice": { "title": "Your MAP or list price (optional)", "minimum": 0, "type": "number", "description": "Minimum advertised price for every ASIN in this run, e.g. 24.99. Offers under it are flagged and the verdict compares the cheapest unauthorized offer with it. Without it, the comparison uses your own lowest offer, else the Buy Box price." }, "mapPrices": { "title": "MAP price per ASIN (optional)", "type": "object", "description": "A different MAP for each ASIN, e.g. {\"B0BSHF7WHW\": 24.99, \"B07PGL2ZSL\": 12.5}. Overrides the single MAP above." }, "condition": { "title": "Offer condition", "enum": [ "new", "all" ], "type": "string", "description": "New offers only (where hijackers sell) or all offers including used and renewed.", "default": "new" }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Remember the sellers of each ASIN in a named storage in your account, so the next run reports new sellers, sellers that left and Buy Box changes. Schedule the Actor daily and it becomes a hijacker alert feed.", "default": true }, "historyStoreName": { "title": "History storage name", "type": "string", "description": "Name of the key-value store that keeps the seller history. Use a different name per brand or client to keep their histories apart.", "default": "amazon-offers-history" }, "maxOffersPerAsin": { "title": "Max offers per ASIN", "minimum": 10, "maximum": 500, "type": "integer", "description": "Most listings have under 30 offers. The price per ASIN is the same however many offers it has.", "default": 100 }, "amazonIsAuthorized": { "title": "Count Amazon itself as authorized", "type": "boolean", "description": "Treat offers sold by Amazon (Amazon.com, Amazon EU, Amazon Resale) as authorized, as for most brands that sell to Amazon as a vendor.", "default": true }, "urls": { "title": "Product links (optional)", "type": "array", "description": "Same as the ASINs field, for agents that pass links: https://www.amazon.com/dp/B0BSHF7WHW.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }