{ "openapi": "3.0.1", "info": { "title": "Autohome Koubei Scraper: 汽车之家口碑 Owner Reviews", "description": "Extract Autohome 口碑 (koubei) owner reviews: category star ratings, pros/cons text, purchase price/date, reviewer info, and model/trim data for any car series on autohome.com.cn.", "version": "0.2", "x-build-id": "1RUCEa5PZRRvzV2YW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~autohome-koubei-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-autohome-koubei-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/getascraper~autohome-koubei-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-autohome-koubei-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/getascraper~autohome-koubei-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-autohome-koubei-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": { "reviewUrls": { "title": "Review URLs", "type": "array", "description": "One or more Autohome koubei review links, e.g. \"https://k.autohome.com.cn/detail/view_01jmxtga696mtkadsj6gw00000.html\". Find these by browsing a model's koubei page on k.autohome.com.cn and opening any review.", "items": { "type": "string" } }, "expandRelatedReviews": { "title": "Expand to related reviews", "type": "boolean", "description": "When on, each fetched review's \"same model owner reviews\" links are followed to discover more reviews for that model, up to \"Max pages to explore\" hops out and \"Max reviews\" total. Turn off to fetch only the exact URLs you listed above.", "default": true }, "seriesIds": { "title": "Series IDs or model URLs", "type": "array", "description": "One or more Autohome car-model series to summarize. Accepts a bare series ID (e.g. \"4881\") or a full model URL (e.g. \"https://k.autohome.com.cn/4881/\"). Find the series ID in any k.autohome.com.cn/{id}/ model URL. This only produces the model-summary row — it cannot list that model's individual reviews (see \"Review URLs\" above).", "items": { "type": "string" } }, "includeSeriesSummary": { "title": "Include model summary row", "type": "boolean", "description": "When on, emits one extra row per requested series ID (rowType: \"series_summary\") with the model's average score, historical and current-generation review counts, problems-per-hundred (PPH) quality data, category-average ratings, and the most common owner-reported pros/cons phrases.", "default": true }, "since": { "title": "Only reviews posted on/after", "type": "string", "description": "Optional. Only include reviews posted on or after this date (YYYY-MM-DD). Reviews outside this range are still visited during related-review expansion, just not included in the output." }, "onlyNewReviews": { "title": "Only new reviews (incremental mode)", "type": "boolean", "description": "When on, the actor remembers which review IDs it has already emitted (persisted in the key-value store) and only pushes reviews it hasn't seen before. Combine with an Apify Schedule for a recurring monitor of new owner reviews on the models you track.", "default": false }, "maxReviews": { "title": "Max reviews", "minimum": 1, "type": "integer", "description": "Maximum total review rows to emit across all the review URLs you listed and their related-review expansion.", "default": 50 }, "maxCrawlDepth": { "title": "Max pages to explore", "minimum": 0, "type": "integer", "description": "How many hops of \"same model owner reviews\" links to follow outward from each URL in \"Review URLs\" when \"Expand to related reviews\" is on. Each review page links to about 5 others, so depth 2 can reach roughly 25 reviews per seed URL before the \"Max reviews\" cap applies.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Datacenter proxy is sufficient for this target — no residential IP requirement was found during recon (no WAF, no TLS/JA3 gate, no geo-block). Leave this on the default.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }