中古車の価格・在庫リサーチ
Cars.comエンドポイントを使えば、「中古車の価格・在庫リサーチ」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
公開されているCars.comのページを構造化された中古車データに変換します。郵便番号・半径・在庫タイプによる地理的な掲載検索、そして価格・スペック・ディーラー情報・Cars.com独自の取引公平度評価を含む完全な掲載詳細を、正規化JSONで取得できます。認証は不要です。
地域を指定してCars.comの車両掲載を検索し、完全な掲載詳細を構造化JSONで取得できます。
エンドポイントファミリー
2
ドキュメント化されたパラメータ
7
サンプル数
2
ライブカタログスナップショット
稼働エンドポイント
2
メソッド
GET
必須パラメータ
3
スキーマ参照
2
{
"platform": "Cars.com",
"endpoint": "carsdotcom-search",
"method": "GET",
"path": "/carsdotcom/search",
"auth": "apiKey"
}ユースケース
地域を指定してCars.comの車両掲載を検索し、完全な掲載詳細を構造化JSONで取得できます。
Cars.comエンドポイントを使えば、「中古車の価格・在庫リサーチ」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Cars.comエンドポイントを使えば、「車両掲載のモニタリング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Cars.comエンドポイントを使えば、「ディーラー在庫の分析」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のCars.comエンドポイントカタログから取得しています（エンドポイント2件、ドキュメント化されたリクエストパラメータ7個、公開レスポンススキーマ2件）。DocsとPlaygroundが参照しているカタログと同じものです。
Cars.comのエンドポイントは2件、2つのリクエストファミリーに分類されています（Search、Vehicle）。
これらのCars.comエンドポイントには7個のリクエストパラメータがドキュメント化されており、うち3個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
2件のCars.comエンドポイントのうち2件が実際のサンプルレスポンスを、2件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Cars.comのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Cars.comのエンドポイントは2個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/carsdotcom/search
/carsdotcom/vehicle/{listing_id}
エンドポイントカタログ
/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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール carsdotcom_vehicle
関連API
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.
対象企業
Cars.com Inc. · CARS
Cars.comを運営するのはCars.com Inc.（CARS）です。CrawloraのSECエンドポイントは同じ企業のCIKを受け取るため、提出書類・財務・インサイダー取引・13F保有を上記のCars.comエンドポイントと同じAPIキーで取得できます。
SEC提出書類・財務API →Cars.comのスクレイピング方法
Crawloraの Cars.comエンドポイントは、1つの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の各フィールドが含まれており、2回目のリクエストを送らずとも自分のコード内でブランド・車種・走行距離・価格による絞り込みが可能です。
結果のlisting_id（数値IDではなくUUID）を/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のみを受け付けます。ブランドや車種のパラメータには対応しておらず、指定すると上流でエラーになります。各結果にはすでにブランド、車種、グレード、年式、走行距離、価格が含まれているため、実際には一度その地域を検索し、返されたサマリーから欲しいブランド・車種を絞り込む方法を取ります。
これはCrawloraの制限ではなく、Cars.com自身の報告上限です。半径が大きくstock_typeを指定していないなど非常に幅広い検索の場合、Cars.comは実際の数値ではなく10000を報告します。信頼できる件数が必要な場合は、半径を狭めるか在庫タイプを限定してください。
できます。/carsdotcom/vehicle/{listing_id}は、車両スペック、装備特徴、履歴サマリー、価格に加えて、その掲載のディーラー情報も返します。Cars.comがある掲載について公平度評価を持たない場合（通常は比較可能な在庫が不足しているため）、deal_ratingと予測適正価格は省略されます。
呼び出し側にCars.comのアカウントやログインは不要です。必要なのはCrawlora APIキーのみです。