/cargurus/listings/search

curl --request POST \
  --url https://api.anysite.io/api/cargurus/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "makes": [],
  "count": 2,
  "timeout": 300,
  "models": [],
  "stock_type": "used",
  "zip": "<string>",
  "distance": 50000,
  "price_min": 1,
  "price_max": 1,
  "mileage_min": 1,
  "mileage_max": 1,
  "year_min": 1901,
  "year_max": 1901,
  "body_types": [],
  "fuel_types": [],
  "transmissions": [],
  "drivetrains": [],
  "engines": [],
  "exterior_colors": [],
  "interior_colors": [],
  "seats": [],
  "deal_ratings": [],
  "vehicle_history": [],
  "seller_types": [],
  "seller_ids": [],
  "days_on_market_max": 1,
  "mpg_min": 1,
  "only_with_photos": false,
  "only_price_drops": false,
  "only_with_financing": false,
  "only_fees_included": false,
  "hide_salvage": false,
  "hide_fleet": false,
  "sort": "best_match"
}
'

import requests

url = "https://api.anysite.io/api/cargurus/listings/search"

payload = {
    "makes": [],
    "count": 2,
    "timeout": 300,
    "models": [],
    "stock_type": "used",
    "zip": "<string>",
    "distance": 50000,
    "price_min": 1,
    "price_max": 1,
    "mileage_min": 1,
    "mileage_max": 1,
    "year_min": 1901,
    "year_max": 1901,
    "body_types": [],
    "fuel_types": [],
    "transmissions": [],
    "drivetrains": [],
    "engines": [],
    "exterior_colors": [],
    "interior_colors": [],
    "seats": [],
    "deal_ratings": [],
    "vehicle_history": [],
    "seller_types": [],
    "seller_ids": [],
    "days_on_market_max": 1,
    "mpg_min": 1,
    "only_with_photos": False,
    "only_price_drops": False,
    "only_with_financing": False,
    "only_fees_included": False,
    "hide_salvage": False,
    "hide_fleet": False,
    "sort": "best_match"
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    makes: [],
    count: 2,
    timeout: 300,
    models: [],
    stock_type: 'used',
    zip: '<string>',
    distance: 50000,
    price_min: 1,
    price_max: 1,
    mileage_min: 1,
    mileage_max: 1,
    year_min: 1901,
    year_max: 1901,
    body_types: [],
    fuel_types: [],
    transmissions: [],
    drivetrains: [],
    engines: [],
    exterior_colors: [],
    interior_colors: [],
    seats: [],
    deal_ratings: [],
    vehicle_history: [],
    seller_types: [],
    seller_ids: [],
    days_on_market_max: 1,
    mpg_min: 1,
    only_with_photos: false,
    only_price_drops: false,
    only_with_financing: false,
    only_fees_included: false,
    hide_salvage: false,
    hide_fleet: false,
    sort: 'best_match'
  })
};

fetch('https://api.anysite.io/api/cargurus/listings/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/cargurus/listings/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'makes' => [
        
    ],
    'count' => 2,
    'timeout' => 300,
    'models' => [
        
    ],
    'stock_type' => 'used',
    'zip' => '<string>',
    'distance' => 50000,
    'price_min' => 1,
    'price_max' => 1,
    'mileage_min' => 1,
    'mileage_max' => 1,
    'year_min' => 1901,
    'year_max' => 1901,
    'body_types' => [
        
    ],
    'fuel_types' => [
        
    ],
    'transmissions' => [
        
    ],
    'drivetrains' => [
        
    ],
    'engines' => [
        
    ],
    'exterior_colors' => [
        
    ],
    'interior_colors' => [
        
    ],
    'seats' => [
        
    ],
    'deal_ratings' => [
        
    ],
    'vehicle_history' => [
        
    ],
    'seller_types' => [
        
    ],
    'seller_ids' => [
        
    ],
    'days_on_market_max' => 1,
    'mpg_min' => 1,
    'only_with_photos' => false,
    'only_price_drops' => false,
    'only_with_financing' => false,
    'only_fees_included' => false,
    'hide_salvage' => false,
    'hide_fleet' => false,
    'sort' => 'best_match'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/cargurus/listings/search"

	payload := strings.NewReader("{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/cargurus/listings/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/cargurus/listings/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "@type": "CargurusListing",
    "url": "<string>",
    "vin": "<string>",
    "make": "<string>",
    "model": "<string>",
    "year": 123,
    "trim": "<string>",
    "body_type": "<string>",
    "price": 123,
    "total_price": 123,
    "imv": 123,
    "deal_rating": "<string>",
    "deal_score": 123,
    "mileage": 123,
    "drivetrain": "<string>",
    "transmission": "<string>",
    "engine": "<string>",
    "doors": 123,
    "exterior_color": "<string>",
    "interior_color": "<string>",
    "fuel_type": "<string>",
    "city_mpg": 123,
    "highway_mpg": 123,
    "combined_mpg": 123,
    "ev_battery": {
      "@type": "CargurusEvBattery",
      "capacity_kwh": 123,
      "range_mi": 123,
      "charge_time_240v_hr": 123
    },
    "is_cpo": false,
    "is_new": false,
    "safety_rating": 123,
    "days_on_market": 123,
    "distance": 123,
    "stock_number": "<string>",
    "price_drop": 123,
    "original_price": 123,
    "image": "<string>",
    "image_count": 123,
    "options": [],
    "seller_id": "<string>",
    "seller_name": "<string>",
    "seller_city": "<string>",
    "seller_state": "<string>"
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

/cargurus

/cargurus/listings/search

Search CarGurus car listings by make (one or more, required) and optionally model (by name, within a single make) with the full filter set: inventory type (used/new/certified), location and radius, price range, mileage range, model year range, body style, fuel type, transmission, drivetrain, engine, exterior and interior color, number of seats, deal rating, vehicle history (clean title, single owner, no accidents, …), minimum NHTSA safety rating, seller type, minimum dealer rating, specific dealers, maximum days on market, minimum fuel economy and toggles for photos, price drops, financing, dealer-fee-inclusive pricing and hiding salvage or fleet vehicles. Sort by best match, best deal, price, mileage, distance, model year or listing age. Returns listing cards with price, IMV, deal rating, vehicle summary and seller.

Price: 20 credits per 24 results

POST

api

cargurus

listings

/cargurus/listings/search

curl --request POST \
  --url https://api.anysite.io/api/cargurus/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "makes": [],
  "count": 2,
  "timeout": 300,
  "models": [],
  "stock_type": "used",
  "zip": "<string>",
  "distance": 50000,
  "price_min": 1,
  "price_max": 1,
  "mileage_min": 1,
  "mileage_max": 1,
  "year_min": 1901,
  "year_max": 1901,
  "body_types": [],
  "fuel_types": [],
  "transmissions": [],
  "drivetrains": [],
  "engines": [],
  "exterior_colors": [],
  "interior_colors": [],
  "seats": [],
  "deal_ratings": [],
  "vehicle_history": [],
  "seller_types": [],
  "seller_ids": [],
  "days_on_market_max": 1,
  "mpg_min": 1,
  "only_with_photos": false,
  "only_price_drops": false,
  "only_with_financing": false,
  "only_fees_included": false,
  "hide_salvage": false,
  "hide_fleet": false,
  "sort": "best_match"
}
'

import requests

url = "https://api.anysite.io/api/cargurus/listings/search"

payload = {
    "makes": [],
    "count": 2,
    "timeout": 300,
    "models": [],
    "stock_type": "used",
    "zip": "<string>",
    "distance": 50000,
    "price_min": 1,
    "price_max": 1,
    "mileage_min": 1,
    "mileage_max": 1,
    "year_min": 1901,
    "year_max": 1901,
    "body_types": [],
    "fuel_types": [],
    "transmissions": [],
    "drivetrains": [],
    "engines": [],
    "exterior_colors": [],
    "interior_colors": [],
    "seats": [],
    "deal_ratings": [],
    "vehicle_history": [],
    "seller_types": [],
    "seller_ids": [],
    "days_on_market_max": 1,
    "mpg_min": 1,
    "only_with_photos": False,
    "only_price_drops": False,
    "only_with_financing": False,
    "only_fees_included": False,
    "hide_salvage": False,
    "hide_fleet": False,
    "sort": "best_match"
}
headers = {
    "access-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    makes: [],
    count: 2,
    timeout: 300,
    models: [],
    stock_type: 'used',
    zip: '<string>',
    distance: 50000,
    price_min: 1,
    price_max: 1,
    mileage_min: 1,
    mileage_max: 1,
    year_min: 1901,
    year_max: 1901,
    body_types: [],
    fuel_types: [],
    transmissions: [],
    drivetrains: [],
    engines: [],
    exterior_colors: [],
    interior_colors: [],
    seats: [],
    deal_ratings: [],
    vehicle_history: [],
    seller_types: [],
    seller_ids: [],
    days_on_market_max: 1,
    mpg_min: 1,
    only_with_photos: false,
    only_price_drops: false,
    only_with_financing: false,
    only_fees_included: false,
    hide_salvage: false,
    hide_fleet: false,
    sort: 'best_match'
  })
};

fetch('https://api.anysite.io/api/cargurus/listings/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anysite.io/api/cargurus/listings/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'makes' => [
        
    ],
    'count' => 2,
    'timeout' => 300,
    'models' => [
        
    ],
    'stock_type' => 'used',
    'zip' => '<string>',
    'distance' => 50000,
    'price_min' => 1,
    'price_max' => 1,
    'mileage_min' => 1,
    'mileage_max' => 1,
    'year_min' => 1901,
    'year_max' => 1901,
    'body_types' => [
        
    ],
    'fuel_types' => [
        
    ],
    'transmissions' => [
        
    ],
    'drivetrains' => [
        
    ],
    'engines' => [
        
    ],
    'exterior_colors' => [
        
    ],
    'interior_colors' => [
        
    ],
    'seats' => [
        
    ],
    'deal_ratings' => [
        
    ],
    'vehicle_history' => [
        
    ],
    'seller_types' => [
        
    ],
    'seller_ids' => [
        
    ],
    'days_on_market_max' => 1,
    'mpg_min' => 1,
    'only_with_photos' => false,
    'only_price_drops' => false,
    'only_with_financing' => false,
    'only_fees_included' => false,
    'hide_salvage' => false,
    'hide_fleet' => false,
    'sort' => 'best_match'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anysite.io/api/cargurus/listings/search"

	payload := strings.NewReader("{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/cargurus/listings/search")
  .header("access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anysite.io/api/cargurus/listings/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"makes\": [],\n  \"count\": 2,\n  \"timeout\": 300,\n  \"models\": [],\n  \"stock_type\": \"used\",\n  \"zip\": \"<string>\",\n  \"distance\": 50000,\n  \"price_min\": 1,\n  \"price_max\": 1,\n  \"mileage_min\": 1,\n  \"mileage_max\": 1,\n  \"year_min\": 1901,\n  \"year_max\": 1901,\n  \"body_types\": [],\n  \"fuel_types\": [],\n  \"transmissions\": [],\n  \"drivetrains\": [],\n  \"engines\": [],\n  \"exterior_colors\": [],\n  \"interior_colors\": [],\n  \"seats\": [],\n  \"deal_ratings\": [],\n  \"vehicle_history\": [],\n  \"seller_types\": [],\n  \"seller_ids\": [],\n  \"days_on_market_max\": 1,\n  \"mpg_min\": 1,\n  \"only_with_photos\": false,\n  \"only_price_drops\": false,\n  \"only_with_financing\": false,\n  \"only_fees_included\": false,\n  \"hide_salvage\": false,\n  \"hide_fleet\": false,\n  \"sort\": \"best_match\"\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "@type": "CargurusListing",
    "url": "<string>",
    "vin": "<string>",
    "make": "<string>",
    "model": "<string>",
    "year": 123,
    "trim": "<string>",
    "body_type": "<string>",
    "price": 123,
    "total_price": 123,
    "imv": 123,
    "deal_rating": "<string>",
    "deal_score": 123,
    "mileage": 123,
    "drivetrain": "<string>",
    "transmission": "<string>",
    "engine": "<string>",
    "doors": 123,
    "exterior_color": "<string>",
    "interior_color": "<string>",
    "fuel_type": "<string>",
    "city_mpg": 123,
    "highway_mpg": 123,
    "combined_mpg": 123,
    "ev_battery": {
      "@type": "CargurusEvBattery",
      "capacity_kwh": 123,
      "range_mi": 123,
      "charge_time_240v_hr": 123
    },
    "is_cpo": false,
    "is_new": false,
    "safety_rating": 123,
    "days_on_market": 123,
    "distance": 123,
    "stock_number": "<string>",
    "price_drop": 123,
    "original_price": 123,
    "image": "<string>",
    "image_count": 123,
    "options": [],
    "seller_id": "<string>",
    "seller_name": "<string>",
    "seller_city": "<string>",
    "seller_state": "<string>"
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

makes

enum<string>[]

required

Minimum array length: 1

Available options:

acura,

alfa_romeo,

am_general,

amc,

aston_martin,

auburn,

audi,

austin,

austin_healey,

bentley,

bmw,

bugatti,

buick,

cadillac,

caterham,

chevrolet,

chrysler,

citroen,

daewoo,

daihatsu,

datsun,

de_tomaso,

delorean,

desoto,

dodge,

durant,

eagle,

edsel,

excalibur,

ferrari,

fiat,

fisker,

ford,

freightliner,

genesis,

geo,

ghia,

gmc,

graham,

honda,

hudson,

hummer,

hyundai,

ineos,

infiniti,

intermeccanica,

international_harvester,

isuzu,

jaguar,

jeep,

jensen,

kaiser,

karma,

kia,

koenigsegg,

lada,

lamborghini,

lancia,

land_rover,

lexus,

lincoln,

lotus,

lucid,

maserati,

maybach,

mazda,

mclaren,

mercedes_benz,

mercury,

mg,

mini,

mitsubishi,

mobility_ventures,

morgan,

morris,

nash,

nissan,

oldsmobile,

overland,

packard,

pagani,

paige,

panoz,

peerless,

peugeot,

pininfarina,

plymouth,

polestar,

pontiac,

porsche,

qvale,

ram,

renault,

rivian,

rolls_royce,

rover,

saab,

saturn,

scion,

shelby,

smart,

ssc,

studebaker,

subaru,

sunbeam,

suzuki,

tesla,

toyota,

triumph,

vinfast,

volkswagen,

volvo,

vpg,

white,

willys

count

integer

required

Required range: x >= 1

timeout

integer

default:300

Required range: 20 <= x <= 1500

models

string[]

stock_type

enum<string>

default:used

Available options:

used,

new,

certified,

third_party_certified

zip

string | null

Minimum string length: 3

distance

integer

default:50000

Required range: 1 <= x <= 50000

price_min

integer | null

Required range: x >= 0

price_max

integer | null

Required range: x >= 0

mileage_min

integer | null

Required range: x >= 0

mileage_max

integer | null

Required range: x >= 0

year_min

integer | null

Required range: x >= 1900

year_max

integer | null

Required range: x >= 1900

body_types

enum<string>[]

Available options:

coupe,

convertible,

hatchback,

minivan,

pickup_truck,

sedan,

suv,

van,

wagon

fuel_types

enum<string>[]

Available options:

diesel,

electric,

gasoline,

hybrid,

cng,

flex_fuel,

biodiesel,

propane,

fuel_cell

transmissions

enum<string>[]

Available options:

AUTOMATIC,

MANUAL

drivetrains

enum<string>[]

Available options:

FOUR_WHEEL_DRIVE,

FOUR_BY_TWO,

REAR_WHEEL_DRIVE,

ALL_WHEEL_DRIVE,

FRONT_WHEEL_DRIVE

engines

enum<string>[]

Available options:

I4,

I5,

I6,

V6,

V8,

V12

exterior_colors

enum<string>[]

Available options:

BLACK,

WHITE,

GRAY,

SILVER,

BLUE,

RED,

GREEN,

BROWN,

GOLD,

ORANGE,

YELLOW,

PURPLE,

TEAL,

PINK,

UNKNOWN

interior_colors

enum<string>[]

Available options:

BLACK,

WHITE,

GRAY,

SILVER,

BLUE,

RED,

GREEN,

BROWN,

GOLD,

ORANGE,

YELLOW,

PURPLE,

TEAL,

PINK,

UNKNOWN

seats

enum<string>[]

Available options:

TWO,

FOUR,

FIVE,

SIX,

SEVEN,

AT_LEAST_EIGHT

deal_ratings

enum<string>[]

Available options:

great_deal,

good_deal,

fair_deal,

high_price,

overpriced,

no_price_analysis,

uncertain

vehicle_history

enum<string>[]

Available options:

CLEAN_TITLE,

SINGLE_OWNER,

NON_FLEET,

LEMON_FREE,

NO_THEFT_HISTORY,

UNDAMAGED_FRAME,

NON_SALVAGE

nhtsa_safety_min

enum<string> | null

Available options:

3,

4,

5

seller_types

enum<string>[]

Available options:

FRANCHISE_DEALER,

PAYING_DEALER

dealer_rating_min

enum<string> | null

Available options:

ONE_STAR_AND_MORE,

TWO_STAR_AND_MORE,

THREE_STAR_AND_MORE,

FOUR_STAR_AND_MORE,

FIVE_STAR

seller_ids

string[]

days_on_market_max

integer | null

Required range: x >= 0

mpg_min

integer | null

Required range: x >= 0

only_with_photos

boolean

default:false

only_price_drops

boolean

default:false

only_with_financing

boolean

default:false

only_fees_included

boolean

default:false

hide_salvage

boolean

default:false

hide_fleet

boolean

default:false

sort

enum<string>

default:best_match

Available options:

best_match,

best_deal,

price_low,

price_high,

mileage_low,

mileage_high,

distance,

year_new,

year_old,

newest_listed,

oldest_listed

Response

Successful Response

string

required

@type

string

default:CargurusListing

url

string | null

vin

string | null

make

string | null

model

string | null

year

integer | null

trim

string | null

body_type

string | null

price

number | null

total_price

number | null

imv

number | null

deal_rating

string | null

deal_score

number | null

mileage

number | null

drivetrain

string | null

transmission

string | null

engine

string | null

doors

integer | null

exterior_color

string | null

interior_color

string | null

fuel_type

string | null

city_mpg

number | null

highway_mpg

number | null

combined_mpg

number | null

ev_battery

object | null

Show child attributes

is_cpo

boolean

default:false

is_new

boolean

default:false

safety_rating

integer | null

days_on_market

integer | null

distance

number | null

stock_number

string | null

price_drop

number | null

original_price

number | null

image

string | null

image_count

integer | null

options

string[]

seller_id

string | null

seller_name

string | null

seller_city

string | null

seller_state

string | null

/cargurus/listings/price-history /cars/dealers/listings

Token

Ad transparency

App stores

Books

Company & startup intel

Company registries

Compliance & sanctions

Crypto & DeFi

Developer & data

Domains & OSINT

E-commerce & marketplaces

Education & courses

Events & tickets

Finance & markets

Games

Gov & public sector

Jobs

Legal

Local & places

Movies & TV

Music

News & publishing

Package registries

Price comparison

Professional network

Real estate

Research papers

Reviews — consumer & business

Reviews — software & employer

Social media

Travel & hospitality

Utility

Web search

/cargurus/listings/search

Authorizations

Headers

Body

Response