二手车定价和库存研究
Use Cars.com endpoints to turn 二手车定价和库存研究 into repeatable API requests with documented inputs and JSON responses.
将公开的 Cars.com 页面转化为结构化的二手车数据——按邮编、半径和库存类型进行的地理位置房源搜索，以及包含定价、规格、经销商信息和 Cars.com 自有交易公平度评级的完整房源详情，均为规范化 JSON。无需凭证。
按地区搜索 Cars.com 的车辆列表，并获取完整的房源详情，均为结构化 JSON。
Endpoint families
2
Documented params
7
Examples
2
Live catalog snapshot
Active endpoints
2
Methods
GET
Required params
3
Schema refs
2
{
"platform": "Cars.com",
"endpoint": "carsdotcom-search",
"method": "GET",
"path": "/carsdotcom/search",
"auth": "apiKey"
}Use cases
按地区搜索 Cars.com 的车辆列表，并获取完整的房源详情，均为结构化 JSON。
Use Cars.com endpoints to turn 二手车定价和库存研究 into repeatable API requests with documented inputs and JSON responses.
Use Cars.com endpoints to turn 车辆房源监控 into repeatable API requests with documented inputs and JSON responses.
Use Cars.com endpoints to turn 经销商库存分析 into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Cars.com endpoint catalog — 2 endpoints, 7 documented request parameters, and 2 published response schemas — the same catalog Docs and Playground run against.
2 documented Cars.com endpoints, grouped into 2 request families — Search and Vehicle.
7 request parameters are documented across those Cars.com endpoints, 3 of them required — the full input contract is public before you write any integration code.
2 of the 2 Cars.com endpoints ship a recorded example response, and 2 carry a documented response schema — you can code against the real JSON before the first request.
Cars.com endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
2 hosted MCP tools back the Cars.com endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/carsdotcom/search
/carsdotcom/vehicle/{listing_id}
Endpoint catalog
/carsdotcom/searchSearches Cars.com for new and used car listings, returning normalized vehicle summaries (make, model, trim, year, mileage, exterior color, drivetrain, fuel type, pricing, seller, images) plus the total matching count. Credential-free public data sourced directly from Cars.com's own public search API.
Response notes
- `total_count` reflects Cars.com's own reported matching-result count for the applied filters, not just `len(vehicles)`. Cars.com caps this figure at `10000` for very broad searches (e.g. no filters at all) rather than reporting the true count beyond that. - `is_cpo` is set when Cars.com marks the listing as certified pre-owned. - An invalid `stock_type` value returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "total_count": 10000, "page": 1, "page_size": 24, "vehicles": [ { "listing_id": "a6ea5d6f-0395-4f9d-94d5-724c4d7414de", "vin": "JTHKD5BH9G2270550", "year": 2016, "make": "Lexus", "model": "CT 200h", "trim": "Base", "body_style": "Hatchback", "mileage": 63436, "exterior_color": "white", "drivetrain": "Front-wheel Drive", "fuel_type": "Hybrid", "stock_type": "Used", "price": 21992, "seller": {"dealer_name": "Lexus of Cerritos", "zip": "90703"}, "images": ["https://platform.cstatic-images.com/large/in/v2/2b36ae52-fc12-53e4-9ae5-6d931aec6878/1f5784d2-4853-48a2-9ccb-e56f0fd2c59f/7IaYP6lvanG6iPgFM2TPpNxb5gY.jpg"], "url": "https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/" } ], "source_url": "https://graph.cars.com/graphql/api" } } ```
MCP tool carsdotcom_search
/carsdotcom/vehicle/{listing_id}Returns a normalized Cars.com vehicle listing: full vehicle spec (make, model, trim, mileage, colors, engine, transmission, fuel economy, a key-specs table), Cars.com's own deal-fairness rating and predicted fair price, categorized equipment features, an AutoCheck-derived vehicle history report, Cars.com's own price-change history, the seller's notes, dealer detail (name, rating, address, website, phones, hours) or private-seller detail for a for-sale-by-owner listing, and certified-pre-owned/manufacturer-program detail when applicable. Credential-free public data sourced directly from Cars.com's own public GraphQL API.
Response notes
- `model` and `trim` are cleanly split (e.g. `model: "CT 200h"`, `trim: "Base"`). - A delisted or invalid `listing_id` returns a `404`. - `deal_rating` is omitted when Cars.com does not show a deal-fairness assessment for this listing (not enough comparable listings, etc). - `history`'s `owner`/`accidents`/`title` strings are a human-readable summary derived from the boolean fields alongside them (`one_owner`, `no_accidents`, `clean_title`, ...) — prefer the booleans for programmatic checks. This is not a substitute for a full paid vehicle history report. - `key_specs` and `price_history` are frequently empty arrays — Cars.com only populates them for some listings. - `dealer` is populated for a dealer listing; `private_seller` is populated instead for a for-sale-by-owner listing. A listing has at most one of the two. - `certified_pre_owned_program` is only populated for a certified-pre-owned listing (`is_cpo: true`); `new_vehicle_program` is only populated when Cars.com attaches a manufacturer incentive program to a new-inventory listing. Both are omitted otherwise. Example response: ```json { "code": 200, "msg": "OK", "data": { "listing_id": "a6ea5d6f-0395-4f9d-94d5-724c4d7414de", "vin": "JTHKD5BH9G2270550", "year": 2016, "make": "Lexus", "model": "CT 200h", "trim": "Base", "body_style": "Hatchback", "mileage": 63436, "exterior_color": "White", "drivetrain": "Front-wheel Drive", "fuel_type": "Hybrid", "stock_type": "USED", "price": 21992, "images": ["https://platform.cstatic-images.com/in/v2/.../1.jpg"], "url": "https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/", "title": "Used 2016 Lexus CT 200h Base", "stock_number": "G2270550", "interior_color": "Parchment", "engine": "1.8L I-4 DOHC, variable valve control, regular unleaded, engine", "transmission": "Automatic", "cylinder_count": 4, "door_count": 4, "mpg_city": 43, "mpg_highway": 40, "deal_rating": { "rating": "fair", "good_price_min": 17591, "good_price_max": 19566, "predicted_price": 17950, "predicted_price_difference": -4042 }, "features": [ {"category": "Safety", "items": ["Automatic Emergency Braking", "Backup Camera", "Brake Assist", "Stability Control"]} ], "history": { "owner": "Multiple Owners", "accidents": "No accidents reported", "title": "Clean", "one_owner": false, "no_accidents": true, "clean_title": true, "report_url": "https://www.autocheck.com/vehiclehistory/?vin=JTHKD5BH9G2270550&siteID=7071", "report_source": "autocheck" }, "sellers_notes": "This vehicle includes a Money-Back Guarantee* and passed our precise inspection process...", "dealer": { "name": "Lexus of Cerritos", "rating": 4.8, "review_count": 4101, "address": "18800 Studebaker Rd, Cerritos, CA 90703", "website": "https://www.cerritoslexus.com/", "phones": [{"area_code": "888", "local_number": "3375218", "phone_type": "PRIMARY"}], "hours": [{"day": "MON", "department": "Sales", "start_at": "09:00:00", "end_at": "21:00:00"}] }, "listed_days": 13, "total_price_change_display": "$0", "price_history": [ {"description": "Listed", "inserted_at": "2026-07-22T01:17:35", "list_price": 21992, "list_price_display": "$21,992"} ], "source_url": "https://graph.cars.com/graphql/api" } } ```
MCP tool carsdotcom_vehicle
Related APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
Company coverage
Cars.com Inc. · CARS
Cars.com is operated by Cars.com Inc. (CARS). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the Cars.com endpoints above.
SEC filings & financials API →How to scrape Cars.com
Crawlora 的 Cars.com 端点用一个 API 密钥返回规范化 JSON 形式的车辆搜索和完整房源详情——搜索是基于地理位置而非自由文本，因此工作流是先缩小地区范围，再解析你所关心的具体房源。
/carsdotcom/search 接受 zip、radius、stock_type（new、used、cpo 或 all）和 page 参数。它没有品牌、车型或自由文本参数——搜索是基于地理位置的，你需要在自己的代码中从规范化结果里筛选出想要的品牌和车型。
total_count 是 Cars.com 自己针对所应用筛选条件报告的匹配数量，而不是你这一页中的车辆数量，并且对于范围非常宽泛的搜索，该值会被限制在 10000。将固定值 10000 视为“至少有这么多”，而不是真实总数。
每条结果都已经带有 vin、year、make、model、trim、body_style、mileage、exterior_color、drivetrain、fuel_type、stock_type、price、seller 和 images 字段——足以在你自己的代码中按品牌/车型/里程/价格进行筛选，而无需再发起第二次请求。
将某条结果的 listing_id（一个 UUID，而非数字 ID）传给 /carsdotcom/vehicle/{listing_id}，即可获取完整的规格表：发动机、变速箱、燃油经济性、关键规格表、分类整理的配置特性、经销商信息、类似 AutoCheck 的历史摘要，以及 Cars.com 自有的交易公平度评级和预测公平价格。
定期重新运行同样的地理位置搜索，以跟踪新增库存和价格变动。已下架或无效的 listing_id 会返回 404，这是判断某辆车已售出或已被下架的最清晰信号。
FAQ
调用 Crawlora 的 /carsdotcom/search 端点，传入邮编、半径，以及可选的 stock_type（new、used、cpo 或 all）。它会返回规范化的车辆摘要，以及 Cars.com 自己报告的匹配总数，均为结构化 JSON。
在请求中不可以。/carsdotcom/search 只接受 zip、radius、stock_type 和 page 参数——传入品牌或车型参数不受支持，且会在上游导致失败。由于每条结果已经包含品牌、车型、配置、年份、里程和价格，实际做法是先搜索该地区一次，再从返回的摘要中筛选出你想要的品牌和车型。
这是 Cars.com 自身的报告上限，而不是 Crawlora 的限制。对于非常宽泛的搜索——例如半径很大且未指定 stock_type——Cars.com 会报告 10000，而不是真实数字。如果你需要一个可信的计数，请缩小半径或限定库存类型。
可以——/carsdotcom/vehicle/{listing_id} 会在车辆规格、配置特性、历史摘要和定价之外，一并返回该房源的经销商信息。当 Cars.com 对某条房源没有公平度评估时（通常是因为可比库存不足），deal_rating 和预测公平价格会被省略。
调用方不需要 Cars.com 账号或登录——只需要你的 Crawlora API 密钥。