{ "openapi": "3.0.1", "info": { "title": "Amazon Customer Insights & Aspect Sentiment", "description": "Extract Amazon's \"Customers say\" insights per ASIN: the AI review summary plus every aspect customers mention, with sentiment and mention counts. Negative and mixed aspects surface the content gaps competitors leave open, ready for FAQ and SEO copy.", "version": "0.1", "x-build-id": "vA6mfGrDeZUe0tlrw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~amazon-customer-insights-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-amazon-customer-insights-extractor", "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/fanndev~amazon-customer-insights-extractor/runs": { "post": { "operationId": "runs-sync-fanndev-amazon-customer-insights-extractor", "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/fanndev~amazon-customer-insights-extractor/run-sync": { "post": { "operationId": "run-sync-fanndev-amazon-customer-insights-extractor", "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": [ "asins" ], "properties": { "asins": { "title": "ASINs", "type": "array", "description": "Amazon ASINs to analyse. Full product URLs are accepted too — the ASIN is extracted from them.", "default": [ "B00XIKPUK4", "B087F16GKW", "B07ZPKN6YR" ], "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "com", "ca", "co.uk", "de", "fr", "it", "es", "com.au", "in" ], "type": "string", "description": "Amazon domain to query. Only amazon.com and amazon.ca were verified during development; other domains need a residential proxy in that country and may return localized aspect names.", "default": "com" }, "emitAspectRows": { "title": "Emit one row per aspect", "type": "boolean", "description": "Adds a row per aspect (sentiment, mentions, rank, share) alongside the product summary row, so the dataset can be sorted and filtered by sentiment directly.", "default": true }, "contentGapsOnly": { "title": "Content gaps only", "type": "boolean", "description": "Return only the negative and mixed aspects — the complaints and split opinions a listing has not addressed. This is the shortlist for FAQ and SEO copy.", "default": false }, "minMentions": { "title": "Minimum mentions", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Drop aspects mentioned fewer than this many times. Aspects whose count Amazon did not publish are always kept.", "default": 0 }, "delaySeconds": { "title": "Delay between products (seconds)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Pacing between product pages. Amazon bot-walls fast anonymous crawling.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is strongly recommended — Amazon blocks datacentre IPs on product pages within a few requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }