{ "openapi": "3.0.1", "info": { "title": "Chotot Scraper – Vietnam Classifieds (Chợ Tốt)", "description": "Scrape Chợ Tốt (chotot.com), Vietnam's largest classifieds site: cars, motorbikes, apartments, houses, phones, laptops and 70+ categories in 63 provinces. Extract price in VND, location, seller type, brand, model, year, area and every attribute. Pay per listing.", "version": "0.1", "x-build-id": "qgnK52CbnjqhS8f9f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/anxuanng~chotot-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-anxuanng-chotot-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/anxuanng~chotot-scraper/runs": { "post": { "operationId": "runs-sync-anxuanng-chotot-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/anxuanng~chotot-scraper/run-sync": { "post": { "operationId": "run-sync-anxuanng-chotot-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": "Keyword", "type": "string", "description": "Free text such as \"iphone 15\", \"honda vision\", \"căn hộ 2 phòng ngủ\". Empty = all listings in the category." }, "category": { "title": "Category", "enum": [ "1000", "1010", "1020", "1040", "1030", "1050", "2000", "2010", "2020", "2050", "2060", "2080", "2030", "5000", "5010", "5040", "5030", "5070", "5050", "5020", "5090", "5060", "5080", "13000", "13010", "15000", "15010", "15020", "15030", "15040", "12000", "12010", "12020", "12030", "12050", "12060", "12040", "7000", "7010", "9000", "9030", "9060", "9070", "14000", "14070", "14080", "14030", "14010", "14020", "14050", "14060", "14090", "14040", "14110", "11000", "11010", "3000", "3030", "3050", "3060", "3070", "3080", "3090", "4000", "4040", "4070", "4020", "4010", "4050", "4060", "8000", "8010", "8030", "6000", "6020", "6030" ], "type": "string", "description": "Chợ Tốt category. Leave empty to search all categories." }, "region": { "title": "Province / city", "enum": [ "13000", "12000", "3017", "5027", "2011", "5024", "2010", "10060", "10059", "5025", "1001", "5026", "7043", "2012", "7042", "5028", "10061", "9053", "9054", "11067", "2013", "5029", "9056", "10062", "1003", "8049", "1004", "4019", "5030", "1005", "1006", "7044", "5031", "9055", "11068", "9057", "10063", "11069", "5032", "4020", "8050", "1007", "7045", "1002", "7046", "6038", "3016", "7047", "10130", "6039", "5033", "11070", "2014", "4021", "10064", "8051", "6040", "5034", "5035", "10065", "5036", "1008", "11071" ], "type": "string", "description": "Leave empty for nationwide." }, "priceMin": { "title": "Min price (VND)", "minimum": 0, "type": "integer", "description": "Optional." }, "priceMax": { "title": "Max price (VND)", "minimum": 0, "type": "integer", "description": "Optional." }, "sort": { "title": "Sort", "enum": [ "newest", "price_asc" ], "type": "string", "description": "Newest first, or cheapest first.", "default": "newest" }, "sellerType": { "title": "Seller type", "enum": [ "all", "private", "company" ], "type": "string", "description": "Private individuals, shops/dealers, or both.", "default": "all" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional chotot.com listing URLs; only the listing ID pages (…/123456789.htm) are supported as direct inputs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlyNewListings": { "title": "Only new listings", "type": "boolean", "description": "Return only listings you have not received from an earlier run of the same search (same keyword, category, region, price and seller filters). Turn on for scheduled monitoring, e.g. new cars or apartments every morning, so you never pay twice for a listing.", "default": false }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Charged per listing pushed.", "default": 100 }, "fetchDetails": { "title": "Fetch listing details", "type": "boolean", "description": "Adds GPS coordinates, full image set and every attribute of the listing. Charged as a separate 'detail' event.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is enough." } } }, "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 } } } } } } } } } }