{ "openapi": "3.0.1", "info": { "title": "Carousell Listings Scraper", "description": "Scrapes Carousell listings from search results or direct URLs across Singapore, Philippines, Malaysia, Hong Kong, Indonesia, Taiwan, Australia, Canada, and New Zealand. Returns each listing with price, condition, description, and seller details.", "version": "0.0", "x-build-id": "P31AtrDYbVnBcK43N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~carousell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~carousell-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~carousell-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": { "keyword": { "title": "Search term for listings", "type": "string", "description": "Search keyword or product name to find listings on Carousell (e.g. 'iphone 15', 'sofa'). If provided, filters below are applied alongside the keyword search." }, "startUrl": { "title": "Carousell listing or search URL", "type": "string", "description": "Direct URL to a Carousell search or category page. If provided, keyword and filter inputs are ignored." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many listings to collect per run." }, "country": { "title": "Country", "enum": [ "sg", "ph", "my", "hk", "id", "tw", "au", "ca", "nz" ], "type": "string", "description": "Country/region to search in. Options: sg (Singapore), ph (Philippines), my (Malaysia), hk (Hong Kong), id (Indonesia), tw (Taiwan), au (Australia), ca (Canada), nz (New Zealand)." }, "condition": { "title": "Condition", "enum": [ "", "new", "used", "unspecified" ], "type": "string", "description": "Filter by item condition." }, "priceMin": { "title": "Min Price", "minimum": 0, "type": "integer", "description": "Minimum price filter (in local currency)." }, "priceMax": { "title": "Max Price", "minimum": 0, "type": "integer", "description": "Maximum price filter (in local currency)." }, "sortBy": { "title": "Sort By", "enum": [ "3", "5", "6" ], "type": "string", "description": "Sort order for search results.", "default": "3" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies required for Cloudflare bypass." }, "includeListingDetails": { "title": "📄 Include listing details", "type": "boolean", "description": "Opens each listing page and adds a listingDetails block: full description, category, every photo, item attributes (model, storage, colour and so on), likes, offers and comments counts, location name, address and coordinates, meet-up points, deal options, created, modified and expiry dates. It also fills the description, category, location, images, updatedAt and likeCount columns. One extra request per listing. Charged only for a row that receives it.", "default": false }, "includeSellerProfile": { "title": "🧑‍💼 Include seller profile", "type": "boolean", "description": "Opens each listing page and adds a sellerProfile block: seller ID, name, join date, followers, feedback score and count, positive, neutral and negative review counts, response rate, seller type, and ID, mobile and email verification flags. One extra request per listing, shared with the listing details option. Charged only for a row that receives it.", "default": 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 } } } } } } } } } }