{ "openapi": "3.0.1", "info": { "title": "Carousell Scraper - Listings, Prices & Seller Leads", "description": "Scrape Carousell listings, prices, conditions, photos, meet-up locations and seller leads across Singapore, Malaysia, the Philippines and Hong Kong. Pure HTTP, no browser, so runs are fast and never time out. Includes GPS coordinates, seller verification and a 0-100 lead score.", "version": "0.1", "x-build-id": "fHh51DIINjvrsOuyG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~carousell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-carousell-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/scrapesage~carousell-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-carousell-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/scrapesage~carousell-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-carousell-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": { "region": { "title": "Carousell region", "enum": [ "sg", "my", "ph", "hk" ], "type": "string", "description": "Which Carousell marketplace to scrape. The proxy is automatically pinned to the matching country.", "default": "sg" }, "categoryUrls": { "title": "Categories to browse", "type": "array", "description": "Category pages to scrape. Paste a full URL (https://www.carousell.sg/categories/computers-tech-213/) or just the slug (computers-tech-213). NOTE: slugs are region-specific. Verified working - Singapore: computers-tech-213, womens-fashion-4, luxury-20, video-gaming-264, furniture-home-living-13, men-s-fashion-3, toys-collectibles-12. Malaysia: women-s-fashion-4, hobbies-toys-6245, cars-32, property-102. Philippines: luxury-20, womens-fashion-4, toys-board-games-12. Hong Kong: luxury-20, womens-fashion-4, furniture-home-living-13, toys-collectibles-12. If a slug returns nothing, the scraper automatically falls back to that region's verified categories. Each category is deep-paginated by price band and sort order.", "items": { "type": "string" } }, "keywords": { "title": "Keyword filter (optional)", "type": "array", "description": "Keep only listings whose title or description contains one of these words, e.g. \"iphone 15\". Filtering runs while crawling, so the scraper keeps paginating until your item limit is met. Leave empty to keep every listing. If you give keywords but no category, five popular categories are scanned.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Any Carousell URL - a category page, a single listing (/p/...), or a seller profile (/u/...). Categories are deep-paginated; listings are scraped in full detail.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sellerUsernames": { "title": "Seller usernames", "type": "array", "description": "Carousell usernames (without @) to pull public listings from, e.g. \"collectors88\".", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum records to return. Set 0 for no limit (the run still stops safely before its timeout).", "default": 100 }, "fetchDetails": { "title": "Fetch full listing details", "type": "boolean", "description": "Open each listing to add the full description, brand, exact meet-up address + GPS coordinates, deal methods, offer/comment counts, category path and full seller profile. Slower, and billed per enriched listing.", "default": false }, "includeSellerLeads": { "title": "Include seller leads", "type": "boolean", "description": "Emit one de-duplicated seller record per seller found, with verification flags, followers, positive/negative review split, tenure, response rate and a 0-100 leadScore. Requires \"Fetch full listing details\".", "default": false }, "deepPagination": { "title": "Deep pagination", "type": "boolean", "description": "Carousell returns only 48 results per URL. When enabled, the scraper partitions the inventory by price band and sort order to reach far more unique listings (measured: 481 from one starting point). Disable for a single fast page.", "default": true }, "sortBy": { "title": "Sort order", "enum": [ "1", "3", "4" ], "type": "string", "description": "Result ordering. Leave empty for Carousell's default." }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in the region's local currency. Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in the region's local currency. Leave empty for no maximum." }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between requests. Raise it for very large runs.", "default": 700 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify residential proxies pinned to the selected region's country, which is what Carousell requires - datacenter IPs are refused. You may supply your own proxy URLs instead.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }