{ "openapi": "3.0.1", "info": { "title": "MX Amazon Reviews Scraper with Advanced", "description": "This MX Amazon Reviews Scraper is designed to extract a vast amount of reviews (up to tens of thousands) for a specified ASIN on Amazon Mexico with high efficiency. Utilizing advanced review filters, it ensures you capture as many relevant reviews as possible.", "version": "0.0", "x-build-id": "88BKvby0xHKHecpSN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delicious_zebu~mx-amazon-reviews-scraper-with-advanced/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delicious_zebu-mx-amazon-reviews-scraper-with-advanced", "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/delicious_zebu~mx-amazon-reviews-scraper-with-advanced/runs": { "post": { "operationId": "runs-sync-delicious_zebu-mx-amazon-reviews-scraper-with-advanced", "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/delicious_zebu~mx-amazon-reviews-scraper-with-advanced/run-sync": { "post": { "operationId": "run-sync-delicious_zebu-mx-amazon-reviews-scraper-with-advanced", "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": [ "ASIN", "sort_reviews_by", "filter_by_verified_purchase_only", "filter_by_ratings", "filter_by_mediaType", "unique_only" ], "properties": { "ASIN": { "title": "ASIN", "maxItems": 10000, "uniqueItems": false, "type": "array", "description": "Provide either an ASIN (E.G., B0CC1F5CGH)", "default": [ "B0CC1F5CGH" ], "items": { "type": "string" } }, "End_date": { "title": "End Date", "type": "string", "description": "Select the end date to scrape all reviews from today until this specified date.", "default": "1990-01-01" }, "unique_only": { "title": "Unique Reviews Only", "type": "boolean", "description": "Enable this option to deduplicate reviews. If disabled, the same review may appear multiple times in different filters (e.g., both 'All stars' and '5 star only').", "default": false }, "sort_reviews_by": { "title": "Sort Reviews By", "type": "array", "description": "Select how to sort reviews. Default: All options ('Top reviews' and 'Most recent') are selected.", "items": { "type": "string", "enum": [ "helpful", "recent" ], "enumTitles": [ "Top reviews", "Most recent" ] }, "default": [ "helpful", "recent" ] }, "filter_by_verified_purchase_only": { "title": "Filter By Verified Purchase", "type": "array", "description": "Filter reviews based on purchase verification. Default: All options ('All reviewers' and 'Verified purchase only') are selected.", "items": { "type": "string", "enum": [ "all_reviews", "avp_only_reviews" ], "enumTitles": [ "All reviewers", "Verified purchase only" ] }, "default": [ "all_reviews", "avp_only_reviews" ] }, "filter_by_ratings": { "title": "Filter By Ratings (Note: It is recommended that you manually select all options.)", "type": "array", "description": "Filter reviews by rating type. By default, only the '5 star only' option is selected. (To maximize the number of reviews collected, it is recommended that you manually select all options.)", "items": { "type": "string", "enum": [ "all_stars", "five_star", "four_star", "three_star", "two_star", "one_star", "positive", "critical" ], "enumTitles": [ "All stars", "5 star only", "4 star only", "3 star only", "2 star only", "1 star only", "Positive reviews", "Critical reviews" ] }, "default": [ "five_star" ] }, "filter_by_mediaType": { "title": "Filter By Media Type", "type": "array", "description": "Filter reviews by media content. Default: All options ('Text, image, video' and 'Image and video reviews only') are selected.", "items": { "type": "string", "enum": [ "all_contents", "media_reviews_only" ], "enumTitles": [ "Text, image, video", "Image and video reviews only" ] }, "default": [ "all_contents", "media_reviews_only" ] } } }, "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 } } } } } } } } } }