Com APIautohome.com.cn ↗
Search Autohome's extensive car catalog by brand, model series, or natural language to instantly find matching vehicles with their current pricing information. Get detailed results that help you compare different car options and prices all in one place.
curl -X GET 'https://api.parse.bot/scraper/07fefef5-8acd-4966-b49a-dbaa279de848/search_cars?query=%E5%AE%9D%E9%A9%AC' \ -H 'X-API-Key: $PARSE_API_KEY'
Runs the site's car search for a free-text query (a brand such as 宝马, a series such as 宝马X5, or criteria such as 20万SUV) and returns matching car series in one request. `series` always lists the matching series: when the query resolves to a brand or to selection criteria it holds the site's top matches (the site shows at most 15 in this view) and `total_series_count` is the site's total count; when the query resolves to one exact series, `series` holds that single series and `matched_series` additionally carries its details and trim (spec) list, otherwise `matched_series` is null. Prices are in CNY yuan; dealer prices are local to `city_id` and null when no local quote exists; `energy` and `sale_rank` may be null. A query the site cannot map to any car returns an empty `series` with `total_series_count` 0. No pagination is available for this view.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Free-text car search term as a user would type it in the site's search box (brand, series, or criteria). |
| city_id | string | Autohome numeric city id used for local dealer prices (110100 = 北京, 310100 = 上海). |
{
"type": "object",
"fields": {
"query": "echoed search term",
"series": "array of series summaries: series_id, series_name, brand_id, brand_name, level, energy, displacement, power, dealer_min_price, dealer_max_price, price_reduction, sale_rank, sale_desc, sale_state, logo, url",
"matched_brand": "object {brand_id, brand_name} when the query resolved to a brand, else null",
"matched_series": "object with series details and `specs` (trim list: spec_id, spec_name, guide_price, local_min_price, owner_avg_price, engine_power, url) when the query resolved to one exact series, else null",
"related_queries": "array of related search terms suggested by the site",
"total_series_count": "integer, site's total number of matching series"
},
"sample": {
"data": {
"query": "宝马",
"series": [
{
"url": "https://www.autohome.com.cn/66/",
"logo": "https://car2.autoimg.cn/cardfs/series/g32/M03/EE/48/autohomecar__Chtk2Wc-0A2AGKUSAAfb3s50zos139.png",
"level": "中型车",
"power": "245Ps",
"energy": "汽油",
"brand_id": 15,
"sale_desc": "中型车销量NO.6",
"sale_rank": 6,
"series_id": 66,
"brand_name": "宝马",
"sale_state": "在售",
"series_name": "宝马3系",
"displacement": "2.0T",
"price_reduction": 50000,
"dealer_max_price": 265000,
"dealer_min_price": 208000
}
],
"matched_brand": {
"brand_id": 15,
"brand_name": "宝马"
},
"matched_series": null,
"related_queries": [
"新能源",
"宝马7系",
"530领先"
],
"total_series_count": 120
},
"status": "success"
}
}About the Com API
The Com API on Parse exposes 1 endpoint for the publicly available data on autohome.com.cn. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.