{ "openapi": "3.0.1", "info": { "title": "Carousell Products Scraper", "description": "Carousell scraper for product listings via keyword search or search by image across 6 APAC marketplaces (SG, MY, PH, HK, TW, ID). Extract prices, seller data and full listing details with visual search.", "version": "1.0", "x-build-id": "6K6YBlEr3w0ZOUttE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devcake~carousell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devcake-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/devcake~carousell-scraper/runs": { "post": { "operationId": "runs-sync-devcake-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/devcake~carousell-scraper/run-sync": { "post": { "operationId": "run-sync-devcake-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": { "domain": { "title": "Domain", "enum": [ "sg", "ph", "hk", "tw", "my", "id" ], "type": "string", "description": "Select the Carousell marketplace region. The proxy country is matched automatically.", "default": "sg" }, "queries": { "title": "Search Queries or URLs", "type": "array", "description": "Search terms, or Carousell links — product, search, or seller profile (e.g. carousell.sg/u/summervzt/ to scrape a seller's listings). Links are detected automatically; maxItems applies per query.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 20, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to extract per query. Minimum is 20.", "default": 20 }, "detail": { "title": "Fetch Full Details", "type": "boolean", "description": "Fetch each listing's full data (all photos, videos, address, category, dates, comments/offers) plus the seller's dossier (rating, reviews, verification, verified orders). Adds one small request per listing and one page request per seller.", "default": false }, "imageUrls": { "title": "Image URLs", "type": "array", "description": "Public image URLs (JPG or PNG) to search by. Each image returns visually similar listings, up to about 200 per image. Text filters and sorting do not apply to image search. Results include full listing details automatically.", "items": { "type": "string" } }, "imageBase64": { "title": "Image (base64)", "type": "string", "description": "Paste a base64-encoded JPG or PNG, with or without the data:image/...;base64, prefix. Use this when the photo is not hosted anywhere. One image per run; use Image URLs for several." }, "sort": { "title": "Sort by", "enum": [ "newest", "oldest", "price_asc", "price_desc" ], "type": "string", "description": "How the marketplace orders the results.", "default": "newest" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only listings at or above this price." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only listings at or below this price." }, "conditions": { "title": "Conditions", "type": "array", "description": "Only listings in the selected condition(s).", "items": { "type": "string", "enum": [ "Brand new", "Like new", "Lightly used", "Well used", "Heavily used" ], "enumTitles": [ "Brand new", "Like new", "Lightly used", "Well used", "Heavily used" ] } }, "deliveryOnly": { "title": "Delivery available only", "type": "boolean", "description": "Only listings that can be shipped.", "default": false }, "meetupOnly": { "title": "Meet-up only", "type": "boolean", "description": "Only listings that support meet-up.", "default": false }, "latitude": { "title": "Location latitude", "type": "number", "description": "Center latitude of the area filter. Set together with Longitude." }, "longitude": { "title": "Location longitude", "type": "number", "description": "Center longitude of the area filter." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "type": "number", "description": "Radius in km around the location. Used only when latitude and longitude are set.", "default": 10 } } }, "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 } } } } } } } } } }