{ "openapi": "3.0.1", "info": { "title": "Tokopedia Scraper & Price Monitor - Prices, Discounts, Sold", "description": "Tokopedia search results by keyword: price in IDR, original price, discount, rating, units sold, shop name, shop city and shop badge. Monitor mode returns only products new in the results and price drops since the last run. No login. Export as JSON, CSV or Excel. Unofficial.", "version": "0.1", "x-build-id": "xTvY71oPDBaVhIw3U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~tokopedia-search-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-tokopedia-search-price-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/neverempty~tokopedia-search-price-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-tokopedia-search-price-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/neverempty~tokopedia-search-price-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-tokopedia-search-price-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", "properties": { "searchQueries": { "title": "Search terms", "type": "array", "description": "What you would type into the Tokopedia search box, for example sepatu lari, kopi arabika, iphone 15. Indonesian words find the most products. Leave Search terms and Search URLs both empty to run the example search sepatu lari.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional. Tokopedia search pages copied from your browser, for example https://www.tokopedia.com/find/sepatu-lari or https://www.tokopedia.com/search?st=product&q=sepatu%20lari&ob=5. The search words and the sort order (ob) are used; other filters in the URL are not (the run log says which were ignored).", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "relevance", "reviews", "newest", "price-asc", "price-desc" ], "type": "string", "description": "Sort order for every search (overrides the order in a pasted URL). Empty = Most relevant for a normal run and Reviews in monitor mode. Most relevant reshuffles between requests, so Reviews or Newest are the steadier lists to watch." }, "maxResultsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "Most products returned for one search (Tokopedia shows 60 per page). Empty = 60. In monitor mode it limits the products returned per search in one run; the rest come in the next run." }, "maxPages": { "title": "Pages per search", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many results pages (60 products each) to read for each search, 1 to 5. Empty = just enough pages for Max products per search. In monitor mode every run reads this many pages and compares them." }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "On (default): return products Tokopedia marks as ads (TopAds) too, marked sponsored true. Off: leave them out.", "default": true }, "onlyMatchingTitles": { "title": "Only products whose title contains every search word", "type": "boolean", "description": "On: leave out products whose title does not contain every search word (Tokopedia also shows related products). Off (default): return them all, each marked titleMatchesSearch true or false.", "default": false }, "onlyNew": { "title": "Monitor mode: only new products and price drops", "type": "boolean", "description": "On: every run reads the same pages of each search and returns only products that appear in these results for the first time (changeType new-in-results) and products whose price changed as set in Price change alerts (changeType price-change, with previousPrice). The first run returns up to Max products per search (changeType first-check) and remembers them as the starting point. Each run that reads the list is charged the run start fee; runs where nothing changed return a free row saying so." }, "priceChangeAlerts": { "title": "Monitor mode: price change alerts", "enum": [ "drops", "any", "off" ], "type": "string", "description": "Which price changes monitor mode returns, comparing the price in IDR shown on the search card with the price this watch remembered. Empty = price drops only.", "default": "drops" }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Keeps separate memories for monitor mode, for example one per client (letters, digits, dot, dash, underscore; up to 40). Runs with the same watch name and search share what has already been returned." }, "resetMonitoringState": { "title": "Start the watch again", "type": "boolean", "description": "On: forget what this watch has seen for these searches before running, so this run is a first check again. Off or empty: keep the memory." } } }, "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 } } } } } } } } } }