{
"openapi": "3.0.1",
"info": {
"title": "Tokopedia Scraper — Products, Prices, Reviews & Change Monitor",
"description": "Scrape Tokopedia products with price, discount, units sold, seller tier, COD and offer labels, plus shop and product reviews with photos. Monitor mode returns only what changed since the last run — price moves, discounts starting, units sold, products gone. No API key.",
"version": "0.1",
"x-build-id": "Wpof5w7DqWQm4qhcR"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lergassy~tokopedia-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lergassy-tokopedia-reviews-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/lergassy~tokopedia-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-lergassy-tokopedia-reviews-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/lergassy~tokopedia-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-lergassy-tokopedia-reviews-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",
"properties": {
"mode": {
"title": "🛍️ What to get",
"enum": [
"search",
"monitor"
],
"type": "string",
"description": "Search — every matching product with price, discount, units sold, seller and labels. Monitor — run the same search on a schedule and get back only what changed since last time: price up or down, a discount that started or ended, units sold moving, a product gone from the results. Unchanged products are not returned and not charged for.",
"default": "search"
},
"monitorName": {
"title": "🔖 Monitor name",
"type": "string",
"description": "Keeps separate memories for separate watches. Use one name per keyword set — \"iphone-jakarta\", \"competitor-shop\" — so two schedules never overwrite each other's history.",
"default": "default"
},
"searchTerms": {
"title": "🔍 Search keywords",
"type": "array",
"description": "Find products by keyword, the way a shopper would: hair mask, iphone 15. Every match comes back as a product row, and with the toggle below, with its reviews too.",
"items": {
"type": "string"
}
},
"maxProductsPerTerm": {
"title": "💯 Products per keyword",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "How many products to take from each keyword, best matches first.",
"default": 20
},
"includeProductReviews": {
"title": "⭐ Reviews for each product found ($)",
"type": "boolean",
"description": "Collect the reviews of every product the search returns. Charged per review, like shop reviews.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Max reviews per product",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Upper limit per product when the toggle above is on.",
"default": 50
},
"startUrls": {
"title": "🛍️ Tokopedia shop URLs",
"type": "array",
"description": "Tokopedia shop or product URLs, for example https://www.tokopedia.com/makarizo-advisor or a product page. Leave empty to search by keyword instead — the keyword path is faster and returns the full product card.",
"items": {
"type": "string"
}
},
"maxReviewsPerShop": {
"title": "Max reviews per shop",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Limit how many reviews are scraped per shop",
"default": 200
},
"reviewsSort": {
"title": "Sort reviews by",
"enum": [
"recent",
"helpful",
"highest",
"lowest"
],
"type": "string",
"description": "Order in which reviews are scraped",
"default": "recent"
},
"ratingFilter": {
"title": "Filter by rating",
"enum": [
"all",
"5",
"4",
"3",
"2",
"1",
"with_media"
],
"type": "string",
"description": "Only scrape reviews with a given star rating, or only reviews that include photos/videos",
"default": "all"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. Recommended for larger runs.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}