{ "openapi": "3.0.1", "info": { "title": "Tokopedia Product Scraper — Prices, Sold & Sellers", "description": "Search Tokopedia by keyword or search URL and save product cards with IDR price, old price, discount, rating, units sold, shop name, and city. HTTP search API, no browser. Built for price checks and catalog research in Indonesia.", "version": "0.1", "x-build-id": "GI5mmFXkmuMr74wfm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~tokopedia-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-tokopedia-product-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/crawloop~tokopedia-product-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-tokopedia-product-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/crawloop~tokopedia-product-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-tokopedia-product-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": { "query": { "title": "Search query", "type": "string", "description": "Tokopedia keyword, for example sepatu or iphone." }, "queries": { "title": "Search queries (batch)", "type": "array", "description": "Optional extra keywords. Each query uses the same page cap and filters.", "items": { "type": "string" } }, "searchUrls": { "title": "Tokopedia search URLs", "type": "array", "description": "Search URLs that include q=. Product page URLs are rejected.", "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "relevance", "price_asc", "price_desc", "newest" ], "type": "string", "description": "Result order on Tokopedia search.", "default": "relevance" }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Search pages per query or URL (1–20). Stops earlier when maxItems is reached.", "default": 1 }, "maxItems": { "title": "Max products per query", "minimum": 1, "type": "integer", "description": "Cap on products saved per keyword or search URL." }, "startPage": { "title": "Start page", "minimum": 1, "type": "integer", "description": "First results page (1-based).", "default": 1 }, "minPrice": { "title": "Minimum price (IDR)", "minimum": 0, "type": "number", "description": "Drop cards cheaper than this amount in Indonesian rupiah." }, "maxPrice": { "title": "Maximum price (IDR)", "minimum": 0, "type": "number", "description": "Drop cards more expensive than this amount in Indonesian rupiah." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep cards with at least this rating (0–5). Cards without a rating are dropped when this is set." }, "minSold": { "title": "Minimum units sold", "minimum": 0, "type": "integer", "description": "Keep cards whose sold label is at least this number. Cards without a sold label are dropped when this is set." }, "deduplicateIds": { "title": "Deduplicate product IDs", "type": "boolean", "description": "Save each productId once across the whole run.", "default": true }, "maxConcurrency": { "title": "Query concurrency", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many keywords or URLs to fetch in parallel (1–4).", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave off. The search API answers from the platform IP. Turn on a residential proxy only if a run returns no cards.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }