{ "openapi": "3.0.1", "info": { "title": "Tokopedia Catalog Monitor", "description": "Track changes in Tokopedia product prices, stock, availability, and variants across runs. Scrape keyword results, aggregate product details with reviews, and shop details with products and seller reviews—an unofficial Tokopedia scraper for catalog monitoring and marketplace analysis.", "version": "1.0", "x-build-id": "Ej58Qnc3AOicclYfo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlstone~tokopedia-catalog-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlstone-tokopedia-catalog-monitor", "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/crawlstone~tokopedia-catalog-monitor/runs": { "post": { "operationId": "runs-sync-crawlstone-tokopedia-catalog-monitor", "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/crawlstone~tokopedia-catalog-monitor/run-sync": { "post": { "operationId": "run-sync-crawlstone-tokopedia-catalog-monitor", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "monitor", "discover", "productDetail", "shopDetail" ], "type": "string", "description": "Choose one operation. Discover is preselected with a sample keyword for a ready-to-run search." }, "productUrls": { "title": "Products to monitor", "minItems": 1, "maxItems": 10, "uniqueItems": true, "type": "array", "description": "Used only to create a monitor. Enter 1–10 unique public Tokopedia product URLs. Omit monitorId.", "items": { "type": "string", "pattern": "^https?://www\\.tokopedia\\.com/[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*/?$" } }, "monitorId": { "title": "Monitor ID", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string", "description": "Used only to continue a monitor. Enter the canonical lowercase UUID returned by its creation run and omit productUrls." }, "keyword": { "title": "Search keyword", "minLength": 1, "type": "string", "description": "Required for discover. One trimmed, non-empty Tokopedia search keyword." }, "maxResults": { "title": "Maximum discovery results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Used only by discover. Results preserve Tokopedia order and duplicate occurrences.", "default": 20 }, "productUrl": { "title": "Product URL", "pattern": "^https?://www\\.tokopedia\\.com/[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*/?$", "type": "string", "description": "Required for productDetail. A public two-segment Tokopedia product URL without query parameters or a fragment." }, "shopUrl": { "title": "Shop URL", "pattern": "^https?://www\\.tokopedia\\.com/[A-Za-z0-9][A-Za-z0-9._-]*/?$", "type": "string", "description": "Required for shopDetail. A public one-segment Tokopedia shop URL without query parameters or a fragment." }, "maxProducts": { "title": "Maximum shop products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Used only by shopDetail. Limits the products nested in the single shop result.", "default": 20 }, "maxReviews": { "title": "Maximum reviews", "minimum": 1, "maximum": 100, "type": "integer", "description": "Used by productDetail and shopDetail. Limits nested product reviews or seller reviews respectively.", "default": 20 } } }, "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 } } } } } } } } } }