{ "openapi": "3.0.1", "info": { "title": "Temu Products Scraper", "description": "Scrape Temu products from the public feed in 25 markets: price, original price, discount, units sold, rating, reviews, rank badges, images and seller. Export CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "JtG6nhfCqUM2t9dF3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~temu-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-temu-products-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/parseforge~temu-products-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-temu-products-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/parseforge~temu-products-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-temu-products-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": { "marketIds": { "title": "Markets", "type": "array", "description": "Temu storefronts to collect from. Each market returns its own products, prices and currency. The United States runs on the datacenter proxy; every other market switches to a residential exit in that country automatically.", "items": { "type": "string", "enum": [ "us", "uk", "de", "fr", "it", "es", "nl", "be", "at", "ie", "pt", "pl", "se", "ch", "ca", "mx", "br", "cl", "co", "au", "nz", "jp", "kr", "sa", "ae" ], "enumTitles": [ "United States (USD)", "United Kingdom (GBP)", "Germany (EUR)", "France (EUR)", "Italy (EUR)", "Spain (EUR)", "Netherlands (EUR)", "Belgium (EUR)", "Austria (EUR)", "Ireland (EUR)", "Portugal (EUR)", "Poland (PLN)", "Sweden (SEK)", "Switzerland (CHF)", "Canada (CAD)", "Mexico (MXN)", "Brazil (BRL)", "Chile (CLP)", "Colombia (COP)", "Australia (AUD)", "New Zealand (NZD)", "Japan (JPY)", "South Korea (KRW)", "Saudi Arabia (SAR)", "United Arab Emirates (AED)" ] }, "default": [ "us" ] }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "includeKeywords": { "title": "Title keywords", "type": "array", "description": "Keep only products whose title contains at least one of these words (case-insensitive). Leave empty to keep everything.", "items": { "type": "string" } }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Keep only products at or below this price, in the market's own currency." }, "minDiscount": { "title": "Minimum discount (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only products discounted by at least this percentage off the crossed-out price." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only products rated at least this many stars (1 to 5)." }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Keep only products with at least this many reviews." }, "minSales": { "title": "Minimum units sold", "minimum": 0, "type": "integer", "description": "Keep only products whose sold counter is at least this number (Temu shows rounded counters such as 1.7K+)." }, "excludeSponsored": { "title": "Skip sponsored products", "type": "boolean", "description": "Drop products Temu marks as ads.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy settings. Leave the default for the United States (datacenter). Markets outside the United States always use a residential exit in their own country.", "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 } } } } } } } } } }