{ "openapi": "3.0.1", "info": { "title": "Chotot Scraper - Vietnam Marketplace Listings", "description": "Chotot scraper to extract listings and classified ads from Chotot.com, Vietnam's largest marketplace. Scrape products by keyword, category, region, and price. Get full listing data including images, seller info, and GPS coordinates. Fast, low-cost, export to JSON, CSV, or Excel", "version": "0.1", "x-build-id": "P8bdrP3oCIstu3feZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hgservices~chotot-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hgservices-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/hgservices~chotot-scraper/runs": { "post": { "operationId": "runs-sync-hgservices-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/hgservices~chotot-scraper/run-sync": { "post": { "operationId": "run-sync-hgservices-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": { "search": { "title": "Search keyword", "type": "string", "description": "Full-text keyword to search for. Combinable with every filter below. Leave empty to scrape whole categories." }, "categoryIds": { "title": "Categories", "uniqueItems": true, "type": "array", "description": "Top-level marketplace categories to scrape. Defaults to all 10 general categories. Property, vehicles and jobs are handled by companion Actors.", "items": { "type": "string", "enum": [ "5000", "14000", "3000", "8000", "4000", "12000", "9000", "11000", "6000", "7000" ], "enumTitles": [ "Đồ điện tử (Electronics)", "Đồ gia dụng, nội thất (Home & furniture)", "Thời trang (Fashion)", "Đồ dùng văn phòng (Office & agriculture)", "Giải trí, Thể thao, Sở thích (Hobbies & sport)", "Thú cưng (Pets)", "Tủ lạnh, máy lạnh, máy giặt (Appliances)", "Mẹ và bé (Mom & baby)", "Dịch vụ, Du lịch (Services & travel)", "Đồ ăn, thực phẩm (Food)" ] }, "default": [ "5000", "14000", "3000", "8000", "4000", "12000", "9000", "11000", "6000", "7000" ] }, "adType": { "title": "Ad type", "enum": [ "all", "sell", "buy", "rent_out", "want_rent" ], "type": "string", "description": "Which kind of ad to return. `all` (the default) returns every type. `sell` is by far the most common single type. Availability varies per category.", "default": "all" }, "regionId": { "title": "Region / Province", "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": "Limit results to a single province. Leave blank to scrape nationwide." }, "maxItems": { "title": "Max items per category", "minimum": 1, "type": "integer", "description": "Number of ads to fetch for EACH selected category. Total output is at most this number times the number of categories (e.g. 50 × 10 categories = up to 500 items).", "default": 50 }, "enrichDetails": { "title": "Add on: Enrich with extra ad details", "type": "boolean", "description": "Add an `attributes` object to every ad with human-readable, category-specific specs (brand, model, capacity, condition, warranty, full address, etc.). Slows the run and increases the cost.", "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 } } }, "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 } } } } } } } } } }