---
type: "firecrawl-provider"
description: "CarGurus.com US used-car marketplace: search listings within a radius of a ZIP code (make/model/trim, price, year, mileage, body style, transmission, 11 sort orders, paginated), read one listing's full detail (price analysis, history, specifications, dealer), resolve free text to make/model/trim ontology ids, list makes and models, and read owner reviews for a model."
use_when: "CarGurus.com US used-car marketplace: search listings within a radius of a ZIP code (make/model/trim, price, year, mileage, body style, transmission, 11 sort orders, paginated), read one listing's full detail (price analysis, history, specifications, dealer), resolve free text to make/model/trim ontology ids, list makes and models, and read owner reviews for a model."
categories: "Retail"
capabilities: 6
credits_per_call: 5
---
# CarGurus on Firecrawl Alexandria

CarGurus.com US used-car marketplace: search listings within a radius of a ZIP code (make/model/trim, price, year, mileage, body style, transmission, 11 sort orders, paginated), read one listing's full detail (price analysis, history, specifications, dealer), resolve free text to make/model/trim ontology ids, list makes and models, and read owner reviews for a model.

- Categories: Retail
- Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail)
- Provider key: `cargurus-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/cargurus-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/openapi.json)

## Capabilities

- [Get listing](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/get_listing): Read one CarGurus listing by its listing id or pasted /details/{id} URL: title, VIN, year/make/model/trim, price and base price in USD with CarGurus' expected price, deal rating and score, mileage, description, options, pictures, listing and vehicle history, NHTSA safety ratings, fuel economy, disclosed dealer fees, the site's specification sections and the selling dealer (address, coordinates, phone, website, hours, rating). A listing that has sold or expired is not_found.
- [List makes](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/list_makes): List the vehicle makes CarGurus offers for used or new inventory, split into popular and other makes, with their ontology ids (m<n>) and logo URLs.
- [List models](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/list_models): List the models of one make on CarGurus (popular and other), with their ontology ids (d<n>) and make_model_trim_paths. An unknown make id is not_found.
- [Model owner reviews](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/model_owner_reviews): Owner review summary for one CarGurus model (entity id d<n>): total ratings, average rating, rating distribution, average rating by model year and the latest owner reviews the site shows. A model the site does not know is not_found.
- [Search listings](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/search_listings): Search CarGurus used-car listings within distance_miles of a US ZIP code. Narrow by ontology entity (make m<n>, model d<n>, trim t<n>) or make_model_trim_paths, price, model year, mileage, body style, transmission and sort order. Returns one page of up to 24 listings (id, VIN, title, year/make/model/trim, price in USD with CarGurus' expected price and deal rating, mileage, days on market, distance, colors, powertrain, photo, dealer summary), the total match count, the resolved search location, selected facets with counts (body style, condition, deal rating, transmission, fuel, drivetrain, seller type, color, trims) and the next page number. Sponsored/featured tiles are listings and are marked by tile_type; merchandising cards are dropped.
- [Suggest vehicles](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/suggest_vehicles): Resolve free text (e.g. 'toyota cam') to CarGurus make, make/model and make/model/trim suggestions with their ontology entity ids and make_model_trim_paths, as the site's search box does.

## 1. Choose this provider when

CarGurus.com US used-car marketplace: search listings within a radius of a ZIP code (make/model/trim, price, year, mileage, body style, transmission, 11 sort orders, paginated), read one listing's full detail (price analysis, history, specifications, dealer), resolve free text to make/model/trim ontology ids, list makes and models, and read owner reviews for a model.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "cargurus-com",
  "capability": "vehicles/get_listing",
  "options": {
    "listing_id": 455322676
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `listing_id` (number): CarGurus inventory listing id (listings[].listing_id from search_listings). Give this or url. Example: `10`
- `url` (string): A CarGurus listing URL, https://www.cargurus.com/details/{listing_id}[?...]. Give this or listing_id. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "cargurus-com",
    capability: "vehicles/get_listing",
    options: {
      listing_id: 455322676,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "cargurus-com",
  "capability": "vehicles/get_listing",
  "options": {
    "listing_id": 455322676
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "cargurus-com",
    "capability": "vehicles/get_listing",
    "options": {
      "listing_id": 455322676
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'cargurus-com/vehicles/get_listing' \
  --options '{"listing_id":455322676}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "cargurus-com",
  "capability": "vehicles/get_listing",
  "options": {
    "listing_id": 455322676
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "cargurus-com",
  "capability": "vehicles/get_listing",
  "options": {
    "listing_id": 455322676
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "base_price": 25998,
  "body_style": "sedan",
  "body_type_group_id": "bg6",
  "cargo_volume": "15 cu ft",
  "condition": "CPO",
  "country": "US",
  "currency": "USD",
  "deal_rating": "GOOD_PRICE",
  "deal_score": 1.0968028,
  "dealer_fees": [
    {
      "amount": 595,
      "name": "Documentation Fee",
      "type": "PrimaryDealerFee"
    }
  ],
  "description": "Recent Arrival! Toyota of Nashua is proud to present this Toyota Gold Certified Heavy Metal 2025 Toyota Camry SE FWD 2.5L 4-Cylinder 16V DOHC eCVT  Features Include  Active Cruise Control Alloy wheels Apple CarPlay/Android Auto Automatic temperature control Back up Camera Front dual zone A/C Fully automatic headlights Heated door mirrors Illuminated entry Radio: Toyota Audio Multimedia w/8\" Touchscreen Remote keyless entry Steering wheel mounted audio controls  Toyota Gold Certified Details:    * Limited Warranty: 12 Month/12,000 Mile Limited Comprehensive Warranty: 12 Month/12,000 Mile (whichever comes first) from certified purchase date   * Powertrain Limited Warranty: 84 Month/100,000 Mile (whichever comes first) from TCUV purchase date   * Vehicle History   * Warranty Deductible: $0   * Roadside Assistance for 7 Year / 100,000 Mile. Standard New-Car Financing Rates Available. Warranty honored at over 1,400 Toyota dealers in the continental U.S. & Canada. Trade-ins accepted. Trouble-free handling of your transaction, including DMV paperwork   * Roadside Assistance   * Multipoint Point Inspection   * Transferable Warranty   Find us at www.toyotaofnashua.com Call us today at 1-833-680-7747 Visit the Car Center at 10 Marmon Dr. Nashua, NH 03060 or Visit the Truck Center at 3 Graham Dr. Nashua, NH 03060.[!@@Additional Info@@!]6 Speakers,AM/FM radio: SiriusXM,Radio data system,Radio: Toyota Audio Multimedia w/8\" Touchscreen,Air Conditioning,Automatic temperature control,Front dual zone A/C,Rear window defroster,Power driver seat,Power steering,Power windows,Remote keyless entry,Steering wheel mounted audio controls,Four wheel independent suspension,Speed-sensing steering,Traction control,4-Wheel Disc Brakes,ABS brakes,Dual front impact airbags,Dual front side impact airbags,Emergency communication system: Safety Connect (up to 10-year trial subscription),Front anti-roll bar,Knee airbag,Low tire pressure warning,Occupant sensing airbag,Overhead airbag,Rear anti-roll bar,Rear side impact airbag,Brake assist,Electronic Stability Control,Back up Camera,Auto High-beam Headlights,Delay-off headlights,Fully automatic headlights,Panic alarm,Security system,Active Cruise Control,Speed control,Bumpers: body-color,Heated door mirrors,Power door mirrors,Spoiler,Turn signal indicator mirrors,Apple CarPlay/Android Auto,Driver door bin,Driver vanity mirror,Front reading lights,Illuminated entry,Leather Shift Knob,Leather steering wheel,Outside temperature display,Overhead console,Passenger vanity mirror,Rear reading lights,Rear seat center armrest,Telescoping steering wheel,Tilt steering wheel,Trip computer,Front Bucket Seats,Front Center Armrest,SofTex & Fabric Seat Trim,Split folding rear seat,Passenger door bin,Alloy wheels,Wheels: 18\" Black-Finished Alloy,Variably intermittent wipers,Features Include:",
  "doors": "4 doors",
  "drivetrain": "Front-Wheel Drive",
  "engine": "2.5L I4 Hybrid",
  "entity_id": "t110635",
  "expected_price": 27311,
  "exterior_color": "Heavy Metal",
  "fuel_economy": {
    "city": 48,
    "combined": 47.55,
    "highway": 47,
    "unit": "MPG"
  },
  "fuel_tank_capacity_gallons": 13,
  "fuel_type": "Hybrid",
  "listing_history": {
    "days_at_dealer": 60,
    "days_on_cargurus": 61
  },
  "listing_id": 455322676,
  "make": "Toyota",
  "make_id": "m7",
  "mileage": 47362,
  "model": "Camry",
  "model_id": "d292",
  "observed_at_ms": 1791172134190,
  "options": [
    "Adaptive Cruise Control",
    "Alloy Wheels",
    "Bluetooth",
    "Backup Camera",
    "Blind Spot Monitoring",
    "Android Auto",
    "CarPlay"
  ],
  "pictures": [
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6590196020224929327-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1559543583767877022-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6617108074144122251-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6678313700822881427-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2952413656572982727-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6781756992966867409-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6520375935861833031-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7443511359100698918-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1424682755208932208-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7180530318955460811-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2184313970588433947-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-4525945154715418285-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-101056370529594909-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-8852913593038692759-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6113030623468036761-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2757053795467950021-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-5668891749492227557-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-4073478527967903183-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1565312409222874-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3367528002708700366-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3020928441645469252-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-9081986282711119783-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-8936710614757371439-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6955289379372619270-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1957087697289750915-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7439777306538317145-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7907230978681282027-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-796688967882005814-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2681064905793508415-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6115810342369054762-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6332944707588815369-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3978840689369045768-1024x768.jpeg"
  ],
  "postal_code": "03062",
  "price": 25998,
  "price_differential": 1313,
  "price_plus_fees": 26593,
  "safety_ratings": {
    "front_crash": null,
    "overall": null,
    "rollover": null,
    "side_crash": null
  },
  "saved_count": 1,
  "seller": {
    "average_rating": 4.28,
    "city": "Nashua",
    "country": "US",
    "hours": [
      {
        "close": "5:00 PM",
        "day": "Sun",
        "open": "11:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Mon",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Tue",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Wed",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Thu",
        "open": "9:00 AM"
      },
      {
        "close": "6:00 PM",
        "day": "Fri",
        "open": "9:00 AM"
      },
      {
        "close": "6:00 PM",
        "day": "Sat",
        "open": "9:00 AM"
      }
    ],
    "inventory_url": "https://www.cargurus.com/Cars/m-Toyota-of-Nashua-sp327343",
    "is_franchise_dealer": true,
    "latitude": 42.7295,
    "longitude": -71.4462,
    "name": "Toyota of Nashua",
    "phone": "+1 877-372-3043",
    "postal_code": "03062",
    "region": "NH",
    "review_count": 25,
    "seller_type": "DEALER",
    "service_provider_id": 327343,
    "street": "10 Marmon Drive",
    "website": "https://www.toyotaofnashua.com/?utm_source=cargurus.com&utm_medium=referral&utm_campaign=cargurus_listings",
    "website_domain": "www.toyotaofnashua.com"
  },
  "specifications": [
    {
      "category": "Overview",
      "items": [
        {
          "key": "make",
          "label": "Make",
          "value": "Toyota"
        },
        {
          "key": "model",
          "label": "Model",
          "value": "Camry"
        },
        {
          "key": "year",
          "label": "Year",
          "value": "2025"
        },
        {
          "key": "trim",
          "label": "Trim",
          "value": "SE FWD"
        },
        {
          "key": "bodyType",
          "label": "Body type",
          "value": "Sedan"
        },
        {
          "key": "exteriorColor",
          "label": "Exterior color",
          "value": "Heavy Metal"
        },
        {
          "key": "interiorColor",
          "label": "Interior color",
          "value": "Black"
        },
        {
          "key": "mileage",
          "label": "Mileage",
          "value": "47,362 mi"
        },
        {
          "key": "vin",
          "label": "VIN",
          "value": "4T1DAACK6SU527131"
        },
        {
          "key": "stockNumber",
          "label": "Stock number",
          "value": "C4664"
        },
        {
          "key": "certified",
          "label": "Certified",
          "value": "Yes"
        },
        {
          "key": "condition",
          "label": "Condition",
          "value": "Certified Pre-Owned"
        }
      ]
    },
    {
      "category": "Fuel economy",
      "items": [
        {
          "key": "fuelTankSize",
          "label": "Fuel tank size",
          "value": "13 gal"
        },
        {
          "key": "combinedFuelEconomy",
          "label": "Combined gas mileage",
          "value": "47 MPG"
        },
        {
          "key": "cityFuelEconomy",
          "label": "City gas mileage",
          "value": "48 MPG"
        },
        {
          "key": "highwayFuelEconomy",
          "label": "Highway gas mileage",
          "value": "47 MPG"
        },
        {
          "key": "fuelType",
          "label": "Fuel type",
          "value": "Hybrid"
        },
        {
          "key": "batteryCapacity",
          "label": "Battery capacity",
          "value": "1 kWh"
        }
      ]
    },
    {
      "category": "Performance",
      "items": [
        {
          "key": "transmission",
          "label": "Transmission",
          "value": "Continuously Variable Transmission"
        },
        {
          "key": "drivetrain",
          "label": "Drivetrain",
          "value": "Front-Wheel Drive"
        },
        {
          "key": "engine",
          "label": "Engine",
          "value": "2.5L I4 Hybrid"
        }
      ]
    },
    {
      "category": "Safety",
      "items": []
    },
    {
      "category": "Measurements",
      "items": [
        {
          "key": "numberOfDoors",
          "label": "Doors",
          "value": "4 doors"
        },
        {
          "key": "frontLegroom",
          "label": "Front legroom",
          "value": "42 in"
        },
        {
          "key": "backLegroom",
          "label": "Back legroom",
          "value": "38 in"
        },
        {
          "key": "cargoVolume",
          "label": "Cargo volume",
          "value": "15 cu ft"
        }
      ]
    },
    {
      "category": "Options",
      "items": []
    }
  ],
  "status": "OPEN",
  "stock_number": "C4664",
  "title": "2025 Toyota Camry SE FWD",
  "transmission": "Continuously Variable Transmission",
  "trim": "SE FWD",
  "url": "https://www.cargurus.com/details/455322676",
  "vehicle_history": {
    "accident_count": 0,
    "has_report": true,
    "owner_count": 1,
    "report_date_ms": 1785970937000
  },
  "vin": "4T1DAACK6SU527131",
  "year": 2025
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get listing

- Capability: `vehicles/get_listing`
- Description: Read one CarGurus listing by its listing id or pasted /details/{id} URL: title, VIN, year/make/model/trim, price and base price in USD with CarGurus' expected price, deal rating and score, mileage, description, options, pictures, listing and vehicle history, NHTSA safety ratings, fuel economy, disclosed dealer fees, the site's specification sections and the selling dealer (address, coordinates, phone, website, hours, rating). A listing that has sold or expired is not_found.
- Instructions: After search_listings, to read the full record of one vehicle. Also accepts a pasted https://www.cargurus.com/details/{id} URL.
- Cost: 5 credits per call
- Capability file: [Get listing](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/get_listing)

Accepted options:
- `listing_id` (number): CarGurus inventory listing id (listings[].listing_id from search_listings). Give this or url. Example: `10`
- `url` (string): A CarGurus listing URL, https://www.cargurus.com/details/{listing_id}[?...]. Give this or listing_id. Example: `<url>`

Response schema example:
```json
{
  "base_price": 25998,
  "body_style": "sedan",
  "body_type_group_id": "bg6",
  "cargo_volume": "15 cu ft",
  "condition": "CPO",
  "country": "US",
  "currency": "USD",
  "deal_rating": "GOOD_PRICE",
  "deal_score": 1.0968028,
  "dealer_fees": [
    {
      "amount": 595,
      "name": "Documentation Fee",
      "type": "PrimaryDealerFee"
    }
  ],
  "description": "Recent Arrival! Toyota of Nashua is proud to present this Toyota Gold Certified Heavy Metal 2025 Toyota Camry SE FWD 2.5L 4-Cylinder 16V DOHC eCVT  Features Include  Active Cruise Control Alloy wheels Apple CarPlay/Android Auto Automatic temperature control Back up Camera Front dual zone A/C Fully automatic headlights Heated door mirrors Illuminated entry Radio: Toyota Audio Multimedia w/8\" Touchscreen Remote keyless entry Steering wheel mounted audio controls  Toyota Gold Certified Details:    * Limited Warranty: 12 Month/12,000 Mile Limited Comprehensive Warranty: 12 Month/12,000 Mile (whichever comes first) from certified purchase date   * Powertrain Limited Warranty: 84 Month/100,000 Mile (whichever comes first) from TCUV purchase date   * Vehicle History   * Warranty Deductible: $0   * Roadside Assistance for 7 Year / 100,000 Mile. Standard New-Car Financing Rates Available. Warranty honored at over 1,400 Toyota dealers in the continental U.S. & Canada. Trade-ins accepted. Trouble-free handling of your transaction, including DMV paperwork   * Roadside Assistance   * Multipoint Point Inspection   * Transferable Warranty   Find us at www.toyotaofnashua.com Call us today at 1-833-680-7747 Visit the Car Center at 10 Marmon Dr. Nashua, NH 03060 or Visit the Truck Center at 3 Graham Dr. Nashua, NH 03060.[!@@Additional Info@@!]6 Speakers,AM/FM radio: SiriusXM,Radio data system,Radio: Toyota Audio Multimedia w/8\" Touchscreen,Air Conditioning,Automatic temperature control,Front dual zone A/C,Rear window defroster,Power driver seat,Power steering,Power windows,Remote keyless entry,Steering wheel mounted audio controls,Four wheel independent suspension,Speed-sensing steering,Traction control,4-Wheel Disc Brakes,ABS brakes,Dual front impact airbags,Dual front side impact airbags,Emergency communication system: Safety Connect (up to 10-year trial subscription),Front anti-roll bar,Knee airbag,Low tire pressure warning,Occupant sensing airbag,Overhead airbag,Rear anti-roll bar,Rear side impact airbag,Brake assist,Electronic Stability Control,Back up Camera,Auto High-beam Headlights,Delay-off headlights,Fully automatic headlights,Panic alarm,Security system,Active Cruise Control,Speed control,Bumpers: body-color,Heated door mirrors,Power door mirrors,Spoiler,Turn signal indicator mirrors,Apple CarPlay/Android Auto,Driver door bin,Driver vanity mirror,Front reading lights,Illuminated entry,Leather Shift Knob,Leather steering wheel,Outside temperature display,Overhead console,Passenger vanity mirror,Rear reading lights,Rear seat center armrest,Telescoping steering wheel,Tilt steering wheel,Trip computer,Front Bucket Seats,Front Center Armrest,SofTex & Fabric Seat Trim,Split folding rear seat,Passenger door bin,Alloy wheels,Wheels: 18\" Black-Finished Alloy,Variably intermittent wipers,Features Include:",
  "doors": "4 doors",
  "drivetrain": "Front-Wheel Drive",
  "engine": "2.5L I4 Hybrid",
  "entity_id": "t110635",
  "expected_price": 27311,
  "exterior_color": "Heavy Metal",
  "fuel_economy": {
    "city": 48,
    "combined": 47.55,
    "highway": 47,
    "unit": "MPG"
  },
  "fuel_tank_capacity_gallons": 13,
  "fuel_type": "Hybrid",
  "listing_history": {
    "days_at_dealer": 60,
    "days_on_cargurus": 61
  },
  "listing_id": 455322676,
  "make": "Toyota",
  "make_id": "m7",
  "mileage": 47362,
  "model": "Camry",
  "model_id": "d292",
  "observed_at_ms": 1791172134190,
  "options": [
    "Adaptive Cruise Control",
    "Alloy Wheels",
    "Bluetooth",
    "Backup Camera",
    "Blind Spot Monitoring",
    "Android Auto",
    "CarPlay"
  ],
  "pictures": [
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6590196020224929327-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1559543583767877022-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6617108074144122251-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6678313700822881427-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2952413656572982727-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6781756992966867409-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6520375935861833031-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7443511359100698918-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1424682755208932208-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7180530318955460811-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2184313970588433947-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-4525945154715418285-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-101056370529594909-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-8852913593038692759-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6113030623468036761-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2757053795467950021-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-5668891749492227557-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-4073478527967903183-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1565312409222874-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3367528002708700366-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3020928441645469252-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-9081986282711119783-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-8936710614757371439-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6955289379372619270-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-1957087697289750915-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7439777306538317145-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-7907230978681282027-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-796688967882005814-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-2681064905793508415-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6115810342369054762-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-6332944707588815369-1024x768.jpeg",
    "https://static.cargurus.com/images/forsale/2026/08/08/06/27/2025_toyota_camry-pic-3978840689369045768-1024x768.jpeg"
  ],
  "postal_code": "03062",
  "price": 25998,
  "price_differential": 1313,
  "price_plus_fees": 26593,
  "safety_ratings": {
    "front_crash": null,
    "overall": null,
    "rollover": null,
    "side_crash": null
  },
  "saved_count": 1,
  "seller": {
    "average_rating": 4.28,
    "city": "Nashua",
    "country": "US",
    "hours": [
      {
        "close": "5:00 PM",
        "day": "Sun",
        "open": "11:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Mon",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Tue",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Wed",
        "open": "9:00 AM"
      },
      {
        "close": "8:00 PM",
        "day": "Thu",
        "open": "9:00 AM"
      },
      {
        "close": "6:00 PM",
        "day": "Fri",
        "open": "9:00 AM"
      },
      {
        "close": "6:00 PM",
        "day": "Sat",
        "open": "9:00 AM"
      }
    ],
    "inventory_url": "https://www.cargurus.com/Cars/m-Toyota-of-Nashua-sp327343",
    "is_franchise_dealer": true,
    "latitude": 42.7295,
    "longitude": -71.4462,
    "name": "Toyota of Nashua",
    "phone": "+1 877-372-3043",
    "postal_code": "03062",
    "region": "NH",
    "review_count": 25,
    "seller_type": "DEALER",
    "service_provider_id": 327343,
    "street": "10 Marmon Drive",
    "website": "https://www.toyotaofnashua.com/?utm_source=cargurus.com&utm_medium=referral&utm_campaign=cargurus_listings",
    "website_domain": "www.toyotaofnashua.com"
  },
  "specifications": [
    {
      "category": "Overview",
      "items": [
        {
          "key": "make",
          "label": "Make",
          "value": "Toyota"
        },
        {
          "key": "model",
          "label": "Model",
          "value": "Camry"
        },
        {
          "key": "year",
          "label": "Year",
          "value": "2025"
        },
        {
          "key": "trim",
          "label": "Trim",
          "value": "SE FWD"
        },
        {
          "key": "bodyType",
          "label": "Body type",
          "value": "Sedan"
        },
        {
          "key": "exteriorColor",
          "label": "Exterior color",
          "value": "Heavy Metal"
        },
        {
          "key": "interiorColor",
          "label": "Interior color",
          "value": "Black"
        },
        {
          "key": "mileage",
          "label": "Mileage",
          "value": "47,362 mi"
        },
        {
          "key": "vin",
          "label": "VIN",
          "value": "4T1DAACK6SU527131"
        },
        {
          "key": "stockNumber",
          "label": "Stock number",
          "value": "C4664"
        },
        {
          "key": "certified",
          "label": "Certified",
          "value": "Yes"
        },
        {
          "key": "condition",
          "label": "Condition",
          "value": "Certified Pre-Owned"
        }
      ]
    },
    {
      "category": "Fuel economy",
      "items": [
        {
          "key": "fuelTankSize",
          "label": "Fuel tank size",
          "value": "13 gal"
        },
        {
          "key": "combinedFuelEconomy",
          "label": "Combined gas mileage",
          "value": "47 MPG"
        },
        {
          "key": "cityFuelEconomy",
          "label": "City gas mileage",
          "value": "48 MPG"
        },
        {
          "key": "highwayFuelEconomy",
          "label": "Highway gas mileage",
          "value": "47 MPG"
        },
        {
          "key": "fuelType",
          "label": "Fuel type",
          "value": "Hybrid"
        },
        {
          "key": "batteryCapacity",
          "label": "Battery capacity",
          "value": "1 kWh"
        }
      ]
    },
    {
      "category": "Performance",
      "items": [
        {
          "key": "transmission",
          "label": "Transmission",
          "value": "Continuously Variable Transmission"
        },
        {
          "key": "drivetrain",
          "label": "Drivetrain",
          "value": "Front-Wheel Drive"
        },
        {
          "key": "engine",
          "label": "Engine",
          "value": "2.5L I4 Hybrid"
        }
      ]
    },
    {
      "category": "Safety",
      "items": []
    },
    {
      "category": "Measurements",
      "items": [
        {
          "key": "numberOfDoors",
          "label": "Doors",
          "value": "4 doors"
        },
        {
          "key": "frontLegroom",
          "label": "Front legroom",
          "value": "42 in"
        },
        {
          "key": "backLegroom",
          "label": "Back legroom",
          "value": "38 in"
        },
        {
          "key": "cargoVolume",
          "label": "Cargo volume",
          "value": "15 cu ft"
        }
      ]
    },
    {
      "category": "Options",
      "items": []
    }
  ],
  "status": "OPEN",
  "stock_number": "C4664",
  "title": "2025 Toyota Camry SE FWD",
  "transmission": "Continuously Variable Transmission",
  "trim": "SE FWD",
  "url": "https://www.cargurus.com/details/455322676",
  "vehicle_history": {
    "accident_count": 0,
    "has_report": true,
    "owner_count": 1,
    "report_date_ms": 1785970937000
  },
  "vin": "4T1DAACK6SU527131",
  "year": 2025
}
```

### List makes

- Capability: `vehicles/list_makes`
- Description: List the vehicle makes CarGurus offers for used or new inventory, split into popular and other makes, with their ontology ids (m<n>) and logo URLs.
- Instructions: To enumerate makes or find a make's id for list_models and search_listings.
- Cost: 5 credits per call
- Capability file: [List makes](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/list_makes)

Accepted options:
- `new_or_used` (string): Default USED. Example: `USED`

Response schema example:
```json
{
  "count": 118,
  "makes": [
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/acura.png",
      "make_id": "m4",
      "name": "Acura",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/jpg/alfa-romeo.jpg",
      "make_id": "m124",
      "name": "Alfa Romeo",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/audi.svg",
      "make_id": "m19",
      "name": "Audi",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/Bentley_logo 1.png",
      "make_id": "m20",
      "name": "Bentley",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/bmw.svg",
      "make_id": "m3",
      "name": "BMW",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/buick.png",
      "make_id": "m21",
      "name": "Buick",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/Cadillac.png",
      "make_id": "m22",
      "name": "Cadillac",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/chevrolet.svg",
      "make_id": "m1",
      "name": "Chevrolet",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/chrysler.png",
      "make_id": "m23",
      "name": "Chrysler",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/dodge.svg",
      "make_id": "m24",
      "name": "Dodge",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m25",
      "name": "Ferrari",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/ford.svg",
      "make_id": "m2",
      "name": "Ford",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m203",
      "name": "Genesis",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/gmc.svg",
      "make_id": "m26",
      "name": "GMC",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/honda.svg",
      "make_id": "m6",
      "name": "Honda",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/hyundai.svg",
      "make_id": "m28",
      "name": "Hyundai",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/infiniti.png",
      "make_id": "m84",
      "name": "INFINITI",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m31",
      "name": "Jaguar",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/jeep.svg",
      "make_id": "m32",
      "name": "Jeep",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/kia.svg",
      "make_id": "m33",
      "name": "Kia",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/Land-Rover-logo-2011-1920x1080.png",
      "make_id": "m35",
      "name": "Land Rover",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/lexus.png",
      "make_id": "m37",
      "name": "Lexus",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/lincoln.png",
      "make_id": "m38",
      "name": "Lincoln",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/maserati.png",
      "make_id": "m40",
      "name": "Maserati",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/mazda.png",
      "make_id": "m42",
      "name": "Mazda",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/mercedes.svg",
      "make_id": "m43",
      "name": "Mercedes-Benz",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/mini.png",
      "make_id": "m45",
      "name": "MINI",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m46",
      "name": "Mitsubishi",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/jpg/nissan.jpg",
      "make_id": "m12",
      "name": "Nissan",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/porsche.svg",
      "make_id": "m48",
      "name": "Porsche",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m191",
      "name": "RAM",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/subaru.png",
      "make_id": "m53",
      "name": "Subaru",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/Tesla.png",
      "make_id": "m112",
      "name": "Tesla",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/toyota.svg",
      "make_id": "m7",
      "name": "Toyota",
      "popular": true
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/vw.svg",
      "make_id": "m55",
      "name": "Volkswagen",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m56",
      "name": "Volvo",
      "popular": true
    },
    {
      "image_url": null,
      "make_id": "m79",
      "name": "AM General",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m133",
      "name": "AMC",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m303",
      "name": "Armstrong-Siddeley",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m110",
      "name": "Aston Martin",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m213",
      "name": "Auburn",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m119",
      "name": "Austin",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m139",
      "name": "Austin-Healey",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m196",
      "name": "Bricklin",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m113",
      "name": "Bugatti",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m117",
      "name": "Citroen",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m285",
      "name": "Continental",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m215",
      "name": "Cord",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m81",
      "name": "Daewoo",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m95",
      "name": "Daihatsu",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m96",
      "name": "Datsun",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m179",
      "name": "De Tomaso",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m97",
      "name": "DeLorean",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m208",
      "name": "DeSoto",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m297",
      "name": "Durant",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m82",
      "name": "Eagle",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m174",
      "name": "Edsel",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m304",
      "name": "Essex",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m198",
      "name": "Excalibur",
      "popular": false
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/png/fiat.jpg",
      "make_id": "m98",
      "name": "FIAT",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m183",
      "name": "Fisker",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m99",
      "name": "Freightliner",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m83",
      "name": "Geo",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m284",
      "name": "Ghia",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m247",
      "name": "Graham",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m186",
      "name": "Hudson",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m27",
      "name": "Hummer",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m283",
      "name": "Ineos",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m241",
      "name": "Intermeccanica",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m158",
      "name": "International Harvester",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m30",
      "name": "Isuzu",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m200",
      "name": "Jensen",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m189",
      "name": "Kaiser",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m233",
      "name": "Karma",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m155",
      "name": "Lada",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m34",
      "name": "Lamborghini",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m100",
      "name": "Lancia",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m248",
      "name": "LaSalle",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m39",
      "name": "Lotus",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m274",
      "name": "Lucid",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m41",
      "name": "Maybach",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m141",
      "name": "McLaren",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m44",
      "name": "Mercury",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m102",
      "name": "MG",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m255",
      "name": "Mobility Ventures",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m150",
      "name": "Morgan",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m151",
      "name": "Morris",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m199",
      "name": "Nash",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m85",
      "name": "Oldsmobile",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m103",
      "name": "Opel",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m299",
      "name": "Overland",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m176",
      "name": "Packard",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m300",
      "name": "Paige",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m86",
      "name": "Panoz",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m301",
      "name": "Peerless",
      "popular": false
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/svg/peugeot.svg",
      "make_id": "m104",
      "name": "Peugeot",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m105",
      "name": "Pininfarina",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m87",
      "name": "Plymouth",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m260",
      "name": "Polestar",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m47",
      "name": "Pontiac",
      "popular": false
    },
    {
      "image_url": "https://static1.cargurus.com/gfx/reskin/jpg/renault.jpg",
      "make_id": "m106",
      "name": "Renault",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m209",
      "name": "REO",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m243",
      "name": "Rivian",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m49",
      "name": "Rolls-Royce",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m131",
      "name": "Rover",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m50",
      "name": "Saab",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m51",
      "name": "Saturn",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m52",
      "name": "Scion",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m135",
      "name": "Shelby",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m111",
      "name": "smart",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m187",
      "name": "SSC",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m164",
      "name": "Studebaker",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m132",
      "name": "Sunbeam",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m54",
      "name": "Suzuki",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m137",
      "name": "Triumph",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m279",
      "name": "VinFast",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m205",
      "name": "VPG",
      "popular": false
    },
    {
      "image_url": null,
      "make_id": "m214",
      "name": "Willys",
      "popular": false
    }
  ],
  "new_or_used": "USED",
  "observed_at_ms": 1791172144131,
  "source_url": "https://www.cargurus.com/api/vehicle-discovery-service/v2/makes?locale=en_US&newOrUsed=USED&origin=SRP&devicePlatform=DESKTOP"
}
```

### List models

- Capability: `vehicles/list_models`
- Description: List the models of one make on CarGurus (popular and other), with their ontology ids (d<n>) and make_model_trim_paths. An unknown make id is not_found.
- Instructions: After list_makes or suggest_vehicles, to pick the model entity_id for search_listings or model_owner_reviews.
- Cost: 5 credits per call
- Capability file: [List models](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/list_models)

Accepted options:
- `make_id` (string, required): Make ontology id, e.g. m7 (Toyota); the bare number 7 is accepted too. Pattern: ^m?[0-9]{1,9}$. Example: `<make_id>`
- `new_or_used` (string): Default USED. Example: `USED`

Response schema example:
```json
{
  "count": 68,
  "make_id": "m7",
  "models": [
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d290"
      ],
      "model_id": "d290",
      "name": "4Runner",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d291"
      ],
      "model_id": "d291",
      "name": "Avalon",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2665",
        "m7"
      ],
      "model_id": "d2665",
      "name": "Avalon Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3515",
        "m7"
      ],
      "model_id": "d3515",
      "name": "bZ",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3516",
        "m7"
      ],
      "model_id": "d3516",
      "name": "bZ Woodland",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3220"
      ],
      "model_id": "d3220",
      "name": "bZ4X",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d2474"
      ],
      "model_id": "d2474",
      "name": "C-HR",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d292"
      ],
      "model_id": "d292",
      "name": "Camry",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d2908"
      ],
      "model_id": "d2908",
      "name": "Camry Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d293"
      ],
      "model_id": "d293",
      "name": "Camry Solara",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d295",
        "m7"
      ],
      "model_id": "d295",
      "name": "Corolla",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3154"
      ],
      "model_id": "d3154",
      "name": "Corolla Cross",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3296",
        "m7"
      ],
      "model_id": "d3296",
      "name": "Corolla Cross Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2697",
        "m7"
      ],
      "model_id": "d2697",
      "name": "Corolla Hatchback",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2840",
        "m7"
      ],
      "model_id": "d2840",
      "name": "Corolla Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d1156",
        "m7"
      ],
      "model_id": "d1156",
      "name": "Crown",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3371"
      ],
      "model_id": "d3371",
      "name": "Crown Signia",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d826"
      ],
      "model_id": "d826",
      "name": "FJ Cruiser",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3243"
      ],
      "model_id": "d3243",
      "name": "GR Corolla",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2436",
        "m7"
      ],
      "model_id": "d2436",
      "name": "GR86",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3314",
        "m7"
      ],
      "model_id": "d3314",
      "name": "Grand Highlander",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3342"
      ],
      "model_id": "d3342",
      "name": "Grand Highlander Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3715",
        "m7"
      ],
      "model_id": "d3715",
      "name": "GRMN Corolla",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d298",
        "m7"
      ],
      "model_id": "d298",
      "name": "Highlander",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d757"
      ],
      "model_id": "d757",
      "name": "Highlander Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d299",
        "m7"
      ],
      "model_id": "d299",
      "name": "Land Cruiser",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d300",
        "m7"
      ],
      "model_id": "d300",
      "name": "Matrix",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2359",
        "m7"
      ],
      "model_id": "d2359",
      "name": "Mirai",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d15"
      ],
      "model_id": "d15",
      "name": "Prius",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2127",
        "m7"
      ],
      "model_id": "d2127",
      "name": "Prius c",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2191",
        "m7"
      ],
      "model_id": "d2191",
      "name": "Prius Plug-In Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d2418"
      ],
      "model_id": "d2418",
      "name": "Prius Prime",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d2150"
      ],
      "model_id": "d2150",
      "name": "Prius v",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d306"
      ],
      "model_id": "d306",
      "name": "RAV4",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2318",
        "m7"
      ],
      "model_id": "d2318",
      "name": "RAV4 Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3446",
        "m7"
      ],
      "model_id": "d3446",
      "name": "RAV4 Plug-in Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d2992"
      ],
      "model_id": "d2992",
      "name": "RAV4 Prime",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d307"
      ],
      "model_id": "d307",
      "name": "Sequoia",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d308"
      ],
      "model_id": "d308",
      "name": "Sienna",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d309"
      ],
      "model_id": "d309",
      "name": "Supra",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d311",
        "m7"
      ],
      "model_id": "d311",
      "name": "Tacoma",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3428",
        "m7"
      ],
      "model_id": "d3428",
      "name": "Tacoma Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d313",
        "m7"
      ],
      "model_id": "d313",
      "name": "Tundra",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d3414",
        "m7"
      ],
      "model_id": "d3414",
      "name": "Tundra Hybrid",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d1516"
      ],
      "model_id": "d1516",
      "name": "Venza",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d827",
        "m7"
      ],
      "model_id": "d827",
      "name": "Yaris",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d2566",
        "m7"
      ],
      "model_id": "d2566",
      "name": "Yaris iA",
      "popular": true
    },
    {
      "make_model_trim_paths": [
        "m7/d1658",
        "m7"
      ],
      "model_id": "d1658",
      "name": "Aristo",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d1798",
        "m7"
      ],
      "model_id": "d1798",
      "name": "Caldina",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d294",
        "m7"
      ],
      "model_id": "d294",
      "name": "Celica",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d3374"
      ],
      "model_id": "d3374",
      "name": "Century",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d3592",
        "m7"
      ],
      "model_id": "d3592",
      "name": "Classic",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d2565",
        "m7"
      ],
      "model_id": "d2565",
      "name": "Corolla iM",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d1443",
        "m7"
      ],
      "model_id": "d1443",
      "name": "Corona",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d296",
        "m7"
      ],
      "model_id": "d296",
      "name": "Cressida",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d297",
        "m7"
      ],
      "model_id": "d297",
      "name": "ECHO",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d1450"
      ],
      "model_id": "d1450",
      "name": "HiAce",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d1185"
      ],
      "model_id": "d1185",
      "name": "Hilux",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d1598",
        "m7"
      ],
      "model_id": "d1598",
      "name": "Hilux Surf",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d1967"
      ],
      "model_id": "d1967",
      "name": "Land Cruiser Prado",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d301",
        "m7"
      ],
      "model_id": "d301",
      "name": "MR2",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d302",
        "m7"
      ],
      "model_id": "d302",
      "name": "MR2 Spyder",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d304"
      ],
      "model_id": "d304",
      "name": "Pickup",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7",
        "m7/d305"
      ],
      "model_id": "d305",
      "name": "Previa",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d3483",
        "m7"
      ],
      "model_id": "d3483",
      "name": "QuickDelivery",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d310",
        "m7"
      ],
      "model_id": "d310",
      "name": "T100",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d312",
        "m7"
      ],
      "model_id": "d312",
      "name": "Tercel",
      "popular": false
    },
    {
      "make_model_trim_paths": [
        "m7/d2190",
        "m7"
      ],
      "model_id": "d2190",
      "name": "Van",
      "popular": false
    }
  ],
  "new_or_used": "USED",
  "observed_at_ms": 1791172149138,
  "source_url": "https://www.cargurus.com/api/vehicle-discovery-service/v2/makes/7/models?locale=en_US&newOrUsed=USED&origin=SRP&devicePlatform=DESKTOP"
}
```

### Model owner reviews

- Capability: `vehicles/model_owner_reviews`
- Description: Owner review summary for one CarGurus model (entity id d<n>): total ratings, average rating, rating distribution, average rating by model year and the latest owner reviews the site shows. A model the site does not know is not_found.
- Instructions: Research on a model's owner satisfaction, keyed by the model_id of a search result or suggestion.
- Cost: 5 credits per call
- Capability file: [Model owner reviews](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/model_owner_reviews)

Accepted options:
- `entity_id` (string, required): Model ontology id, e.g. d292 (Toyota Camry). Pattern: ^d[0-9]{1,9}$. Example: `<entity_id>`

Response schema example:
```json
{
  "average_rating": 4.4597,
  "count": 5,
  "entity_id": "d292",
  "observed_at_ms": 1791172154206,
  "rating_counts": {
    "1": 11,
    "2": 13,
    "3": 67,
    "4": 239,
    "5": 514
  },
  "ratings_by_year": [
    {
      "count": 1,
      "rating": 5,
      "year": 2026
    },
    {
      "count": 9,
      "rating": 4.8889,
      "year": 2025
    },
    {
      "count": 6,
      "rating": 4.6667,
      "year": 2024
    },
    {
      "count": 14,
      "rating": 4.8571,
      "year": 2023
    },
    {
      "count": 16,
      "rating": 4.875,
      "year": 2022
    },
    {
      "count": 17,
      "rating": 4.6471,
      "year": 2021
    },
    {
      "count": 28,
      "rating": 4.7143,
      "year": 2020
    },
    {
      "count": 20,
      "rating": 4.8,
      "year": 2019
    },
    {
      "count": 19,
      "rating": 4.5789,
      "year": 2018
    },
    {
      "count": 13,
      "rating": 4.8462,
      "year": 2017
    },
    {
      "count": 14,
      "rating": 4.5714,
      "year": 2016
    },
    {
      "count": 12,
      "rating": 4.8333,
      "year": 2015
    },
    {
      "count": 10,
      "rating": 4.4,
      "year": 2014
    },
    {
      "count": 8,
      "rating": 4.75,
      "year": 2013
    },
    {
      "count": 24,
      "rating": 4.75,
      "year": 2012
    },
    {
      "count": 27,
      "rating": 4.5185,
      "year": 2011
    },
    {
      "count": 21,
      "rating": 4.4286,
      "year": 2010
    },
    {
      "count": 36,
      "rating": 4.6389,
      "year": 2009
    },
    {
      "count": 26,
      "rating": 4.5,
      "year": 2008
    },
    {
      "count": 60,
      "rating": 4.5,
      "year": 2007
    },
    {
      "count": 22,
      "rating": 4.6364,
      "year": 2006
    },
    {
      "count": 24,
      "rating": 4.375,
      "year": 2005
    },
    {
      "count": 31,
      "rating": 4.5161,
      "year": 2004
    },
    {
      "count": 30,
      "rating": 4.3667,
      "year": 2003
    },
    {
      "count": 31,
      "rating": 4.2581,
      "year": 2002
    },
    {
      "count": 20,
      "rating": 4.55,
      "year": 2001
    },
    {
      "count": 27,
      "rating": 4.2963,
      "year": 2000
    },
    {
      "count": 26,
      "rating": 4.0769,
      "year": 1999
    },
    {
      "count": 20,
      "rating": 4.3,
      "year": 1998
    },
    {
      "count": 29,
      "rating": 4.3793,
      "year": 1997
    },
    {
      "count": 26,
      "rating": 4.4231,
      "year": 1996
    },
    {
      "count": 29,
      "rating": 4.2759,
      "year": 1995
    },
    {
      "count": 16,
      "rating": 4.0625,
      "year": 1994
    },
    {
      "count": 32,
      "rating": 4.125,
      "year": 1993
    },
    {
      "count": 17,
      "rating": 4.3529,
      "year": 1992
    },
    {
      "count": 20,
      "rating": 4.25,
      "year": 1991
    },
    {
      "count": 12,
      "rating": 4.0833,
      "year": 1990
    },
    {
      "count": 10,
      "rating": 3.7,
      "year": 1989
    },
    {
      "count": 14,
      "rating": 4.1429,
      "year": 1988
    },
    {
      "count": 6,
      "rating": 4.1667,
      "year": 1987
    },
    {
      "count": 7,
      "rating": 4.7143,
      "year": 1986
    },
    {
      "count": 11,
      "rating": 4.4545,
      "year": 1985
    },
    {
      "count": 2,
      "rating": 5,
      "year": 1984
    },
    {
      "count": 1,
      "rating": 5,
      "year": 1983
    }
  ],
  "reviews": [
    {
      "author": "Jaime M",
      "content": "I absolutely love my 2021 Toyota Camry. From the moment I got it, I honestly fell in love with it. The car looks sporty and modern, but at the same time it’s very comfortable and smooth to drive. It feels reliable and safe, which gives me a lot of confidence, especially as someone still getting used to driving more often.\n\nThe fuel efficiency is great, and the interior is clean and well-designed. Everything feels solid and easy to use. It’s definitely a great value for the price. If I had to mention something, I wish it had push-button start, but overall I’m extremely happy with my purchase.\n\nI would definitely recommend this car to anyone looking for something reliable, stylish, and comfortable.",
      "posted_at_ms": 1775192895000,
      "rating": 5,
      "review_id": 370050,
      "title": "Review",
      "vehicle": "2021 Toyota SE FWD"
    },
    {
      "author": "Nasir M",
      "content": "Great value. Car runs great and really smooth. No problems",
      "posted_at_ms": 1759717209000,
      "rating": 5,
      "review_id": 365545,
      "title": "Review",
      "vehicle": "2018 Toyota LE"
    },
    {
      "author": "Adam V",
      "content": "A lot of people looking at a certain car for the lowest price end up getting the oldest/first year of a cars generation. Thats because its typically the least expensive year of that particular body style they are looking for. As someone whos sold many cars in the last decade I can assure you, that is typically a big mistake. They often have problems that automakers cant know about until thousands of people have driven them for tens of thousands of miles, or more. I wanted the most reliable car possible. Easy, right? Just buy a Toyota... right? No. Ive seen it with Toyota as well. Many times. So I purposely sought the most recent model year of a generation of cars that are widely considered the most reliable ever made. A 2017 Camry (non-hybrid), if treated well, can be counted on being driven for over 1 million miles without an engine rebuild. They are an engineering marvel of our time. The 2.5l 2AR-FE has to be the most bulletproof example of a gasoline engine to ever sit under a hood. The car itself is well designed and is a flawless performer in normal daily driving. The SE/XSEs in particular have a suspension that can take a quickly-turned corner without skipping a beat. The seats are very comfortable over long drives, but supportive when youre in the curves. It has large windows to avoid blind spots and has airbags in every direction. The crash tests show that its extraordinarily safe if the unthinkable occurs. Its simply a brilliant choice of car. And getting back to my first sentences, the 2017 model had it all nailed down after 6 years of getting closer and closer to perfection. Toyota could have gotten away with not redesigning it for several more years. Easily. However, being the most popular car in the United States is a challenge that requires not letting the customers get bored. So I suppose Ill forgive Toyota for not making the car longer. That said, any one of the years of the seventh generation Camry is a great car to own. But this last year is perfection. Its why I have one. Im proud & grateful to be the owner of a 2017 Camry SE. Ill likely drive it until the car or myself dies. Dont ask me which one will kick the bucket first though, because Im 42 and this engineering marvel of the auto world is only 7. Dont pass up a well treated one.  ",
      "posted_at_ms": 1730011079000,
      "rating": 5,
      "review_id": 353906,
      "title": "Review",
      "vehicle": "2017 Toyota SE"
    },
    {
      "author": "Mary A",
      "content": "I absolutely love the features of my car. The push start, sunroof, heated seats, heated steering wheel, and Apple CarPlay are all fantastic. For the value, the car is a great choice. Being a Toyota, its built to last and is also very fuel-efficient. Both the exterior and interior are incredibly clean, which adds to its appeal.\r\n\r\nThat said, there are a couple of things I wish were different. I’d love if the car had memory seats, and the display screen could be a bit more modern, especially compared to the ones in the Toyota Highlanders. Another small inconvenience is that, unlike the Highlanders where Apple CarPlay connects wirelessly through Bluetooth, my car requires the phone to be plugged in for CarPlay to work. While this isnt a huge issue, it would be more convenient if it were wireless like in the Highlanders.\r\n\r\nOverall, it’s a really cute car and an amazing choice for a first car. Im really happy with it!",
      "posted_at_ms": 1731427124000,
      "rating": 5,
      "review_id": 354516,
      "title": "Review",
      "vehicle": "2022 Toyota SE AWD"
    },
    {
      "author": "Amy W",
      "content": "This car runs good, doesn't burn oil and is excellent on fuel. This car is a 4 cylinder and I have kept it up throughout the last three years I've owned it. I replaced some things such as struts, starter, fixed exhaust that leaked and cylinders. Oil change every month and today as a matter of fact, I just had it done. The tires are one year old and the auto shop said that there is a slight leak within the radiator, but that's about it. \n\n",
      "posted_at_ms": 1753755961000,
      "rating": 4,
      "review_id": 363596,
      "title": "Review",
      "vehicle": "2003 Toyota LE"
    }
  ],
  "source_url": "https://www.cargurus.com/search/resource/auto-show/user-reviews?entityId=d292",
  "total_ratings": 844
}
```

### Search listings

- Capability: `vehicles/search_listings`
- Description: Search CarGurus used-car listings within distance_miles of a US ZIP code. Narrow by ontology entity (make m<n>, model d<n>, trim t<n>) or make_model_trim_paths, price, model year, mileage, body style, transmission and sort order. Returns one page of up to 24 listings (id, VIN, title, year/make/model/trim, price in USD with CarGurus' expected price and deal rating, mileage, days on market, distance, colors, powertrain, photo, dealer summary), the total match count, the resolved search location, selected facets with counts (body style, condition, deal rating, transmission, fuel, drivetrain, seller type, color, trims) and the next page number. Sponsored/featured tiles are listings and are marked by tile_type; merchandising cards are dropped.
- Instructions: Finding used vehicles for sale near a US ZIP code, comparing prices against CarGurus' market value, or enumerating trims and counts for a model in an area. Chain listing_id into get_listing, entity_id into model_owner_reviews, and use suggest_vehicles or list_makes/list_models to obtain entity ids first.
- Cost: 5 credits per call
- Capability file: [Search listings](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/search_listings)

Accepted options:
- `body_type_group_ids` (number[]): Body style group ids: 0 Coupe, 1 Convertible, 3 Hatchback, 4 Minivan, 5 Pickup Truck, 6 Sedan, 7 SUV / Crossover, 8 Van, 9 Wagon (the numeric part of a listing's body_type_group_id bg<n>). Example: `[]`
- `distance_miles` (number): Search radius in miles; the site offers 10, 25, 50, 75, 100, 150, 200, 500 and 50000 (nationwide). Default 50. Example: `10`
- `end_year` (number): Latest model year. Example: `1900`
- `entity_id` (string): CarGurus ontology id to search: a make (m7 = Toyota), model (d292 = Toyota Camry), model year (c33246) or trim (t56819), from suggest_vehicles, list_makes or list_models. Omit to search all vehicles. Pattern: ^[mdct][0-9]{1,9}$. Example: `<entity_id>`
- `make_model_trim_paths` (string[]): Make/model/trim paths as the site encodes them, e.g. ["m7", "m7/d292"] or ["m7/d292/XLE AWD"] (a trims facet value). Usually unnecessary: the site derives them from entity_id. Example: `[]`
- `max_mileage` (number): Maximum odometer miles. Example: `10`
- `max_price` (number): Maximum listing price in USD. Example: `10`
- `max_results` (number): Return only the first N listings of the page (the site's page is 24 tiles; next_page still advances by site page). Default: the whole page. Example: `10`
- `min_mileage` (number): Minimum odometer miles. Example: `10`
- `min_price` (number): Minimum listing price in USD. Example: `10`
- `page` (number): 1-based page number (24 tiles per page); use next_page from the previous result. A page past the last one is invalid_input. Example: `10`
- `sort_dir` (string): Sort direction. Default ASC. Example: `ASC`
- `sort_type` (string): Sort key: BEST_MATCH (default), DEAL_SCORE (best deals first), PRICE, MILEAGE, PROXIMITY, NEWEST_CAR_YEAR, AGE_IN_DAYS (listing age). Example: `BEST_MATCH`
- `start_year` (number): Earliest model year. Example: `1900`
- `transmission_types` (string[]): Transmission filter. Example: `[]`
- `zip` (string, required): 5-digit US ZIP code the search radius is centred on. A ZIP the site cannot resolve is invalid_input. Pattern: ^[0-9]{5}$. Example: `<zip>`

Response schema example:
```json
{
  "count": 8,
  "country": "US",
  "currency": "USD",
  "facets": [
    {
      "filter_key": "bodyTypeGroupIds",
      "label": "Body style",
      "name": "BODY_TYPE_GROUP",
      "options": [
        {
          "count": 1628,
          "label": "Sedan",
          "name": "6",
          "value": 6
        }
      ]
    },
    {
      "filter_key": "newUsed",
      "label": "Condition",
      "name": "VEHICLE_CONDITION",
      "options": [
        {
          "count": 102,
          "label": "Manufacturer Certified",
          "name": "FIRST_PARTY",
          "value": 8
        },
        {
          "count": 1628,
          "label": "Used",
          "name": "USED",
          "value": 2
        },
        {
          "count": 7,
          "label": "Third-Party Certified",
          "name": "THIRD_PARTY",
          "value": 9
        }
      ]
    },
    {
      "filter_key": "dealRatings",
      "label": "Deal ratings",
      "name": "DEAL_RATING",
      "options": [
        {
          "count": 62,
          "label": "Great Deal",
          "name": "GREAT_PRICE",
          "value": 1
        },
        {
          "count": 104,
          "label": "No Price Analysis",
          "name": "NA",
          "value": 4
        },
        {
          "count": 2,
          "label": "Uncertain",
          "name": "OUTLIER",
          "value": 6
        },
        {
          "count": 725,
          "label": "Fair Deal",
          "name": "FAIR_PRICE",
          "value": 5
        },
        {
          "count": 308,
          "label": "High Price",
          "name": "POOR_PRICE",
          "value": 7
        },
        {
          "count": 316,
          "label": "Good Deal",
          "name": "GOOD_PRICE",
          "value": 2
        },
        {
          "count": 111,
          "label": "Overpriced",
          "name": "OVERPRICED",
          "value": 8
        }
      ]
    },
    {
      "filter_key": "transmissionTypes",
      "label": "Transmission",
      "name": "TRANSMISSION_TYPE",
      "options": [
        {
          "count": 1622,
          "label": "Automatic",
          "name": "AUTOMATIC",
          "value": "AUTOMATIC"
        },
        {
          "count": 5,
          "label": "Unknown",
          "name": "UNKNOWN",
          "value": "UNKNOWN"
        },
        {
          "count": 1,
          "label": "Manual",
          "name": "MANUAL",
          "value": "MANUAL"
        }
      ]
    },
    {
      "filter_key": "fuelTypes",
      "label": "Fuel type",
      "name": "FUEL_TYPE",
      "options": [
        {
          "count": 1137,
          "label": "Gasoline",
          "name": "GASOLINE",
          "value": 2
        },
        {
          "count": 490,
          "label": "Hybrid",
          "name": "HYBRID",
          "value": 3
        }
      ]
    },
    {
      "filter_key": "wheelSystems",
      "label": "Drivetrain",
      "name": "DRIVETRAIN",
      "options": [
        {
          "count": 223,
          "label": "All-Wheel Drive",
          "name": "ALL_WHEEL_DRIVE",
          "value": "ALL_WHEEL_DRIVE"
        },
        {
          "count": 1401,
          "label": "Front-Wheel Drive",
          "name": "FRONT_WHEEL_DRIVE",
          "value": "FRONT_WHEEL_DRIVE"
        }
      ]
    },
    {
      "filter_key": "sellerHierarchyTypes",
      "label": "Seller type",
      "name": "SELLER_HIERARCHY_TYPE",
      "options": [
        {
          "count": 264,
          "label": "Franchise dealer",
          "name": "FRANCHISE_DEALER",
          "value": "FRANCHISE_DEALER"
        },
        {
          "count": 1596,
          "label": "CarGurus Partners",
          "name": "PAYING_DEALER",
          "value": "PAYING_DEALER"
        }
      ]
    },
    {
      "filter_key": "colors",
      "label": "Color",
      "name": "COLOR",
      "options": [
        {
          "count": 88,
          "label": "Red",
          "name": "RED",
          "value": "RED"
        },
        {
          "count": 16,
          "label": "Gold",
          "name": "GOLD",
          "value": "GOLD"
        },
        {
          "count": 307,
          "label": "Gray",
          "name": "GRAY",
          "value": "GRAY"
        },
        {
          "count": 329,
          "label": "White",
          "name": "WHITE",
          "value": "WHITE"
        },
        {
          "count": 164,
          "label": "Blue",
          "name": "BLUE",
          "value": "BLUE"
        },
        {
          "count": 232,
          "label": "Silver",
          "name": "SILVER",
          "value": "SILVER"
        },
        {
          "count": 320,
          "label": "Black",
          "name": "BLACK",
          "value": "BLACK"
        },
        {
          "count": 139,
          "label": "Unknown",
          "name": "UNKNOWN",
          "value": "UNKNOWN"
        },
        {
          "count": 3,
          "label": "Teal",
          "name": "TEAL",
          "value": "TEAL"
        },
        {
          "count": 17,
          "label": "Green",
          "name": "GREEN",
          "value": "GREEN"
        },
        {
          "count": 13,
          "label": "Brown",
          "name": "BROWN",
          "value": "BROWN"
        }
      ]
    },
    {
      "filter_key": null,
      "label": "Trim",
      "name": "MODEL_TRIM",
      "options": [
        {
          "count": 393,
          "label": "SE FWD",
          "name": "d292/SE FWD",
          "value": "m7/d292/SE FWD"
        },
        {
          "count": 23,
          "label": "XLE V6",
          "name": "d292/XLE V6",
          "value": "m7/d292/XLE V6"
        },
        {
          "count": 3,
          "label": "SE Nightshade FWD",
          "name": "d292/SE Nightshade FWD",
          "value": "m7/d292/SE Nightshade FWD"
        },
        {
          "count": 6,
          "label": "LE V6",
          "name": "d292/LE V6",
          "value": "m7/d292/LE V6"
        },
        {
          "count": 84,
          "label": "SE AWD",
          "name": "d292/SE AWD",
          "value": "m7/d292/SE AWD"
        },
        {
          "count": 11,
          "label": "XSE V6",
          "name": "d292/XSE V6",
          "value": "m7/d292/XSE V6"
        },
        {
          "count": 2,
          "label": "SE V6",
          "name": "d292/SE V6",
          "value": "m7/d292/SE V6"
        },
        {
          "count": 23,
          "label": "XSE V6 FWD",
          "name": "d292/XSE V6 FWD",
          "value": "m7/d292/XSE V6 FWD"
        },
        {
          "count": 4,
          "label": "XLE V6 FWD",
          "name": "d292/XLE V6 FWD",
          "value": "m7/d292/XLE V6 FWD"
        },
        {
          "count": 4,
          "label": "SE Sport",
          "name": "d292/SE Sport",
          "value": "m7/d292/SE Sport"
        },
        {
          "count": 5,
          "label": "Nightshade AWD",
          "name": "d292/Nightshade AWD",
          "value": "m7/d292/Nightshade AWD"
        },
        {
          "count": 151,
          "label": "SE",
          "name": "d292/SE",
          "value": "m7/d292/SE"
        },
        {
          "count": 2,
          "label": "Special Edition",
          "name": "d292/Special Edition",
          "value": "m7/d292/Special Edition"
        },
        {
          "count": 1,
          "label": "L FWD",
          "name": "d292/L FWD",
          "value": "m7/d292/L FWD"
        },
        {
          "count": 112,
          "label": "XSE FWD",
          "name": "d292/XSE FWD",
          "value": "m7/d292/XSE FWD"
        },
        {
          "count": 187,
          "label": "LE",
          "name": "d292/LE",
          "value": "m7/d292/LE"
        },
        {
          "count": 25,
          "label": "TRD FWD",
          "name": "d292/TRD FWD",
          "value": "m7/d292/TRD FWD"
        },
        {
          "count": 3,
          "label": "CE",
          "name": "d292/CE",
          "value": "m7/d292/CE"
        },
        {
          "count": 2,
          "label": "SE Nightshade AWD",
          "name": "d292/SE Nightshade AWD",
          "value": "m7/d292/SE Nightshade AWD"
        },
        {
          "count": 312,
          "label": "LE FWD",
          "name": "d292/LE FWD",
          "value": "m7/d292/LE FWD"
        },
        {
          "count": 47,
          "label": "XSE AWD",
          "name": "d292/XSE AWD",
          "value": "m7/d292/XSE AWD"
        },
        {
          "count": 11,
          "label": "L",
          "name": "d292/L",
          "value": "m7/d292/L"
        },
        {
          "count": 46,
          "label": "XLE FWD",
          "name": "d292/XLE FWD",
          "value": "m7/d292/XLE FWD"
        },
        {
          "count": 21,
          "label": "XSE",
          "name": "d292/XSE",
          "value": "m7/d292/XSE"
        },
        {
          "count": 1,
          "label": "Nightshade FWD",
          "name": "d292/Nightshade FWD",
          "value": "m7/d292/Nightshade FWD"
        },
        {
          "count": 54,
          "label": "LE AWD",
          "name": "d292/LE AWD",
          "value": "m7/d292/LE AWD"
        },
        {
          "count": 31,
          "label": "XLE AWD",
          "name": "d292/XLE AWD",
          "value": "m7/d292/XLE AWD"
        },
        {
          "count": 6,
          "label": "Base",
          "name": "d292/Base",
          "value": "m7/d292/Base"
        },
        {
          "count": 54,
          "label": "XLE",
          "name": "d292/XLE",
          "value": "m7/d292/XLE"
        }
      ]
    }
  ],
  "listings": [
    {
      "base_price": 13900,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 11,
      "deal_rating": "GOOD_PRICE",
      "deal_score": 1.7363405,
      "distance_miles": 41.531403,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "178 hp 2.5L I4",
      "entity_id": "t56817",
      "expected_price": 14827,
      "exterior_color": "Celestial Silver Metallic",
      "features": [
        "Leather Seats",
        "Sunroof/Moonroof",
        "Power Package",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Heated Seats"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 459696005,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 95316,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 25,
      "mpg_combined": 29.5,
      "mpg_highway": 35,
      "picture_count": 37,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/10/01/12/00/2015_toyota_camry-pic-1366566576560586273-1024x768.jpeg",
      "price": 13900,
      "price_differential": 927,
      "price_drop": null,
      "price_plus_fees": 13900,
      "safety_rating": "5",
      "seller": {
        "city": "Johnston",
        "display_location": "Johnston, RI",
        "name": "Shannon Motors Johnston",
        "phone": "+1 401-289-1650",
        "postal_code": "02919",
        "region": "RI",
        "sales_status": "PAYING",
        "service_provider_id": 273777
      },
      "stock_number": "260411B",
      "tile_type": "LISTING_USED_PRIORITY",
      "title": "2015 Toyota Camry",
      "transmission": "6-Speed Automatic",
      "trim": "XSE",
      "url": "https://www.cargurus.com/details/459696005",
      "vin": "4T1BF1FK4FU898699",
      "year": 2015
    },
    {
      "base_price": 9995,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 2,
      "deal_rating": "FAIR_PRICE",
      "deal_score": 2.2418878,
      "distance_miles": 19.458012,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "178 hp 2.5L I4",
      "entity_id": "t52986",
      "expected_price": 10018,
      "exterior_color": "Silver",
      "features": [
        "Steel Wheels",
        "Bluetooth",
        "Backup Camera"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Gray",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 460531404,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 136300,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 25,
      "mpg_combined": 29.5,
      "mpg_highway": 35,
      "picture_count": 28,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/10/01/21/58/2014_toyota_camry-pic-3945125465540298124-1024x768.jpeg",
      "price": 9995,
      "price_differential": 23,
      "price_drop": null,
      "price_plus_fees": 10490,
      "safety_rating": "5",
      "seller": {
        "city": "Abington",
        "display_location": "Abington, MA",
        "name": "South Shore Auto Gallery",
        "phone": "+1 339-229-8074",
        "postal_code": "02351",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 433302
      },
      "stock_number": "385829",
      "tile_type": "LISTING_USED_FEATURED",
      "title": "2014 Toyota Camry",
      "transmission": "6-Speed Automatic",
      "trim": "LE",
      "url": "https://www.cargurus.com/details/460531404",
      "vin": "4T4BF1FK6ER385829",
      "year": 2014
    },
    {
      "base_price": 29913,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 20,
      "deal_rating": "FAIR_PRICE",
      "deal_score": 2.3177884,
      "distance_miles": 20.88206,
      "doors": "4 doors",
      "drivetrain": "All-Wheel Drive",
      "engine": "205 hp 2.5L I4",
      "entity_id": "t95576",
      "expected_price": 29823,
      "exterior_color": "Midnight Black Metallic",
      "features": [
        "Leather Seats",
        "Sunroof/Moonroof",
        "Navigation System",
        "Adaptive Cruise Control",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Blind Spot Monitoring",
        "Heated Seats",
        "Android Auto",
        "Cold Weather Package",
        "CarPlay"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 458853349,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 25935,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 25,
      "mpg_combined": 29.05,
      "mpg_highway": 34,
      "picture_count": 37,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/09/24/05/35/2021_toyota_camry-pic-947590128718162571-1024x768.jpeg",
      "price": 29913,
      "price_differential": -90,
      "price_drop": null,
      "price_plus_fees": 30598,
      "safety_rating": "5",
      "seller": {
        "city": "Brockton",
        "display_location": "Brockton, MA",
        "name": "Nissan 24",
        "phone": "+1 508-501-8119",
        "postal_code": "02301",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 288235
      },
      "stock_number": "F20279A",
      "tile_type": "LISTING_USED_FEATURED",
      "title": "2021 Toyota Camry",
      "transmission": "8-Speed Automatic",
      "trim": "XSE AWD",
      "url": "https://www.cargurus.com/details/458853349",
      "vin": "4T1K61BK6MU031517",
      "year": 2021
    },
    {
      "base_price": 19752,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 22,
      "deal_rating": "GREAT_PRICE",
      "deal_score": 0.9996408,
      "distance_miles": 43.94483,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "2.5L I4",
      "entity_id": "t95569",
      "expected_price": 21616,
      "exterior_color": "Predawn Gray Mica",
      "features": [
        "Adaptive Cruise Control",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Android Auto",
        "CarPlay"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 458782859,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 70190,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 28,
      "mpg_combined": 32.95,
      "mpg_highway": 39,
      "picture_count": 33,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/09/19/16/20/2021_toyota_camry-pic-4747331874556898242-1024x768.jpeg",
      "price": 19752,
      "price_differential": 1864,
      "price_drop": {
        "current_price": 19752,
        "difference": 408,
        "last_drop_at_ms": 1791041865000,
        "original_price": 21157,
        "previous_price": 20160
      },
      "price_plus_fees": 20437,
      "safety_rating": "5",
      "seller": {
        "city": "Somerset",
        "display_location": "Somerset, MA",
        "name": "Stateline Chrysler Dodge Jeep Ram",
        "phone": "+1 508-690-8995",
        "postal_code": "02725",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 61627
      },
      "stock_number": "K6223A",
      "tile_type": "LISTING_USED_STANDARD",
      "title": "2021 Toyota Camry",
      "transmission": "8-Speed Automatic",
      "trim": "SE FWD",
      "url": "https://www.cargurus.com/details/458782859",
      "vin": "4T1G11AK9MU524226",
      "year": 2021
    },
    {
      "base_price": 24370,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 10,
      "deal_rating": "GOOD_PRICE",
      "deal_score": 1.9533213,
      "distance_miles": 13.918792,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "2.5L I4",
      "entity_id": "t95569",
      "expected_price": 24925,
      "exterior_color": "Super White",
      "features": [
        "Adaptive Cruise Control",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Heated Seats",
        "Android Auto",
        "Cold Weather Package",
        "CarPlay"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 459721303,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 23558,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 28,
      "mpg_combined": 32.95,
      "mpg_highway": 39,
      "picture_count": 34,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/09/25/08/00/2021_toyota_camry-pic-5642936992379636357-1024x768.jpeg",
      "price": 24370,
      "price_differential": 555,
      "price_drop": null,
      "price_plus_fees": 24899,
      "safety_rating": "5",
      "seller": {
        "city": "Norwood",
        "display_location": "Norwood, MA",
        "name": "Nucar Hyundai of Norwood",
        "phone": "+1 617-795-4204",
        "postal_code": "02062",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 44627
      },
      "stock_number": "N1501006A",
      "tile_type": "LISTING_USED_STANDARD",
      "title": "2021 Toyota Camry",
      "transmission": "8-Speed Automatic",
      "trim": "SE FWD",
      "url": "https://www.cargurus.com/details/459721303",
      "vin": "4T1G11AK9MU530091",
      "year": 2021
    },
    {
      "base_price": 23899,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 13,
      "deal_rating": "GOOD_PRICE",
      "deal_score": 1.9615134,
      "distance_miles": 30.430182,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "2.5L I4",
      "entity_id": "t97744",
      "expected_price": 24431,
      "exterior_color": "Silver",
      "features": [
        "Leather Seats",
        "Power Package",
        "Adaptive Cruise Control",
        "Premium Wheels",
        "Blind Spot Monitoring",
        "Heated Seats",
        "Android Auto",
        "CarPlay",
        "Multi Zone Climate Control",
        "SE Package",
        "Bluetooth",
        "Backup Camera",
        "Convenience Package"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 459511240,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 41233,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 28,
      "mpg_combined": 32.95,
      "mpg_highway": 39,
      "picture_count": 24,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/09/21/17/11/2022_toyota_camry-pic-8636544352442801627-1024x768.jpeg",
      "price": 23899,
      "price_differential": 532,
      "price_drop": null,
      "price_plus_fees": 23899,
      "safety_rating": "Not Rated",
      "seller": {
        "city": "Duxbury",
        "display_location": "Duxbury, MA",
        "name": "Millbrook Auto Sales",
        "phone": "+1 781-808-3046",
        "postal_code": "02332",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 362278
      },
      "stock_number": null,
      "tile_type": "LISTING_USED_STANDARD",
      "title": "2022 Toyota Camry",
      "transmission": "8-Speed Automatic",
      "trim": "SE Nightshade FWD",
      "url": "https://www.cargurus.com/details/459511240",
      "vin": "4T1G11AK2NU033286",
      "year": 2022
    },
    {
      "base_price": 23997,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 124,
      "deal_rating": "GREAT_PRICE",
      "deal_score": 0.7872267,
      "distance_miles": 35.082756,
      "doors": "4 doors",
      "drivetrain": "All-Wheel Drive",
      "engine": "202 hp 2.5L I4",
      "entity_id": "t108167",
      "expected_price": 26148,
      "exterior_color": "Supersonic Red",
      "features": [
        "Adaptive Cruise Control",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Blind Spot Monitoring",
        "Heated Seats",
        "Android Auto",
        "Cold Weather Package",
        "CarPlay"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Black",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 449755441,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 33366,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 25,
      "mpg_combined": 29.05,
      "mpg_highway": 34,
      "picture_count": 27,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/07/23/03/29/2024_toyota_camry-pic-1762773421422067581-1024x768.jpeg",
      "price": 23997,
      "price_differential": 2151,
      "price_drop": {
        "current_price": 23997,
        "difference": 1000,
        "last_drop_at_ms": 1791055995000,
        "original_price": 26997,
        "previous_price": 24997
      },
      "price_plus_fees": 24696,
      "safety_rating": "Not Rated",
      "seller": {
        "city": "Attleboro",
        "display_location": "Attleboro, MA",
        "name": "Courtesy Mitsubishi",
        "phone": "+1 508-504-1881",
        "postal_code": "02703",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 155213
      },
      "stock_number": "PM1994",
      "tile_type": "LISTING_USED_STANDARD",
      "title": "2024 Toyota Camry",
      "transmission": "Automatic",
      "trim": "LE AWD",
      "url": "https://www.cargurus.com/details/449755441",
      "vin": "4T1C11BK8RU126400",
      "year": 2024
    },
    {
      "base_price": 25988,
      "body_type": "Sedan",
      "body_type_group_id": "bg6",
      "condition": null,
      "days_on_market": 49,
      "deal_rating": "GREAT_PRICE",
      "deal_score": 0.91109073,
      "distance_miles": 14.935841,
      "doors": "4 doors",
      "drivetrain": "Front-Wheel Drive",
      "engine": "2.5L I4",
      "entity_id": "t102983",
      "expected_price": 28244,
      "exterior_color": "White (Wind Chill Pearl)",
      "features": [
        "Leather Seats",
        "Sunroof/Moonroof",
        "Navigation System",
        "Adaptive Cruise Control",
        "Alloy Wheels",
        "Bluetooth",
        "Backup Camera",
        "Blind Spot Monitoring",
        "Heated Seats",
        "Android Auto",
        "CarPlay"
      ],
      "fuel_type": "Gasoline",
      "interior_color": "Ash",
      "is_cpo": false,
      "is_new": false,
      "listing_id": 456310201,
      "make": "Toyota",
      "make_id": "m7",
      "mileage": 33112,
      "model": "Camry",
      "model_id": "d292",
      "mpg_city": 27,
      "mpg_combined": 31.95,
      "mpg_highway": 38,
      "picture_count": 36,
      "picture_url": "https://static.cargurus.com/images/forsale/2026/08/24/15/39/2023_toyota_camry-pic-7837602455401457577-1024x768.jpeg",
      "price": 25988,
      "price_differential": 2256,
      "price_drop": {
        "current_price": 25988,
        "difference": 700,
        "last_drop_at_ms": 1790879059000,
        "original_price": 28969,
        "previous_price": 26688
      },
      "price_plus_fees": 26583,
      "safety_rating": "Not Rated",
      "seller": {
        "city": "Danvers",
        "display_location": "Danvers, MA",
        "name": "Ira Lexus Danvers",
        "phone": "+1 978-404-7708",
        "postal_code": "01923",
        "region": "MA",
        "sales_status": "PAYING",
        "service_provider_id": 292700
      },
      "stock_number": "PU771783",
      "tile_type": "LISTING_USED_STANDARD",
      "title": "2023 Toyota Camry",
      "transmission": "8-Speed Automatic",
      "trim": "XLE FWD",
      "url": "https://www.cargurus.com/details/456310201",
      "vin": "4T1F11AK4PU771783",
      "year": 2023
    }
  ],
  "location": {
    "latitude": 42.3644,
    "longitude": -71.1012,
    "name": "Cambridge, MA",
    "region": "MA"
  },
  "next_page": 2,
  "observed_at_ms": 1791172123057,
  "page_count": 36,
  "page_listings": 22,
  "page_number": 1,
  "query": {
    "body_type_group_ids": [],
    "distance_miles": 50,
    "end_year": null,
    "entity_id": "d292",
    "make_model_trim_paths": [
      "m7",
      "m7/d292"
    ],
    "max_mileage": null,
    "max_price": null,
    "max_results": 8,
    "min_mileage": null,
    "min_price": null,
    "page": 1,
    "sort_dir": "ASC",
    "sort_type": "BEST_MATCH",
    "start_year": null,
    "transmission_types": [],
    "zip": "02139"
  },
  "source_url": "https://www.cargurus.com/search?zip=02139&distance=50&entityId=d292&sortType=BEST_MATCH&sortDir=ASC",
  "total_listings": 733
}
```

### Suggest vehicles

- Capability: `vehicles/suggest_vehicles`
- Description: Resolve free text (e.g. 'toyota cam') to CarGurus make, make/model and make/model/trim suggestions with their ontology entity ids and make_model_trim_paths, as the site's search box does.
- Instructions: To turn a vehicle name typed by a user into the entity_id / make_model_trim_paths that search_listings and model_owner_reviews take.
- Cost: 5 credits per call
- Capability file: [Suggest vehicles](https://firecrawl.dev/alexandria/agents/providers/cargurus-com/vehicles/suggest_vehicles)

Accepted options:
- `new_or_used` (string): Inventory the suggestions are drawn from. Default USED. Example: `USED`
- `query` (string, required): Free text, at least 2 characters, e.g. 'toyota cam', 'f-150', 'civic si'. Example: `<query>`

Response schema example:
```json
{
  "count": 50,
  "new_or_used": "USED",
  "observed_at_ms": 1791172139154,
  "query": "toyota cam",
  "source_url": "https://www.cargurus.com/api/vehicle-discovery-service/v2/search/suggestions?query=toyota+cam&countryCode=UNITED_STATES&locale=en_US&newOrUsed=USED&origin=SRP&devicePlatform=DESKTOP",
  "suggestions": [
    {
      "entity_id": "d292",
      "label": "Toyota Camry",
      "make_model_trim_paths": [
        "m7/d292",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid",
      "make_model_trim_paths": [
        "m7",
        "m7/d2908"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry TRD FWD",
      "make_model_trim_paths": [
        "m7/d292/TRD FWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "TRD FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XLE",
      "make_model_trim_paths": [
        "m7/d292",
        "m7",
        "m7/d292/XLE"
      ],
      "trim_name": "XLE",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry Special Edition",
      "make_model_trim_paths": [
        "m7/d292/Special Edition",
        "m7/d292",
        "m7"
      ],
      "trim_name": "Special Edition",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry LE",
      "make_model_trim_paths": [
        "m7/d292/LE",
        "m7/d292",
        "m7"
      ],
      "trim_name": "LE",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d293",
      "label": "Toyota Camry Solara",
      "make_model_trim_paths": [
        "m7",
        "m7/d293"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XSE AWD",
      "make_model_trim_paths": [
        "m7/d292/XSE AWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "XSE AWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XSE FWD",
      "make_model_trim_paths": [
        "m7/d292",
        "m7",
        "m7/d292/XSE FWD"
      ],
      "trim_name": "XSE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE FWD",
      "make_model_trim_paths": [
        "m7/d292/SE FWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry LE AWD",
      "make_model_trim_paths": [
        "m7/d292/LE AWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "LE AWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XSE V6",
      "make_model_trim_paths": [
        "m7/d292/XSE V6",
        "m7/d292",
        "m7"
      ],
      "trim_name": "XSE V6",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE Sport",
      "make_model_trim_paths": [
        "m7/d292/SE Sport",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE Sport",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE AWD",
      "make_model_trim_paths": [
        "m7/d292/SE AWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE AWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry LE V6",
      "make_model_trim_paths": [
        "m7/d292/LE V6",
        "m7/d292",
        "m7"
      ],
      "trim_name": "LE V6",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XLE AWD",
      "make_model_trim_paths": [
        "m7/d292/XLE AWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "XLE AWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "m7",
      "label": "Toyota",
      "make_model_trim_paths": [
        "m7"
      ],
      "trim_name": null,
      "type": "Make"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XLE FWD",
      "make_model_trim_paths": [
        "m7/d292",
        "m7",
        "m7/d292/XLE FWD"
      ],
      "trim_name": "XLE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry CE",
      "make_model_trim_paths": [
        "m7/d292/CE",
        "m7/d292",
        "m7"
      ],
      "trim_name": "CE",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d293",
      "label": "Toyota Camry Solara SLE Convertible",
      "make_model_trim_paths": [
        "m7/d293/SLE Convertible",
        "m7",
        "m7/d293"
      ],
      "trim_name": "SLE Convertible",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry FWD",
      "make_model_trim_paths": [
        "m7/d292/FWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XLE V6",
      "make_model_trim_paths": [
        "m7/d292/XLE V6",
        "m7/d292",
        "m7"
      ],
      "trim_name": "XLE V6",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid XLE FWD",
      "make_model_trim_paths": [
        "m7",
        "m7/d2908/XLE FWD",
        "m7/d2908"
      ],
      "trim_name": "XLE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE Nightshade FWD",
      "make_model_trim_paths": [
        "m7/d292/SE Nightshade FWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE Nightshade FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d311",
      "label": "Toyota Tacoma",
      "make_model_trim_paths": [
        "m7/d311",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid XSE FWD",
      "make_model_trim_paths": [
        "m7/d2908/XSE FWD",
        "m7",
        "m7/d2908"
      ],
      "trim_name": "XSE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry L",
      "make_model_trim_paths": [
        "m7/d292/L",
        "m7/d292",
        "m7"
      ],
      "trim_name": "L",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry Deluxe Wagon",
      "make_model_trim_paths": [
        "m7/d292/Deluxe Wagon",
        "m7/d292",
        "m7"
      ],
      "trim_name": "Deluxe Wagon",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry Base",
      "make_model_trim_paths": [
        "m7/d292/Base",
        "m7/d292",
        "m7"
      ],
      "trim_name": "Base",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d313",
      "label": "Toyota Tundra",
      "make_model_trim_paths": [
        "m7/d313",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid LE FWD",
      "make_model_trim_paths": [
        "m7",
        "m7/d2908",
        "m7/d2908/LE FWD"
      ],
      "trim_name": "LE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE V6",
      "make_model_trim_paths": [
        "m7/d292/SE V6",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE V6",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry LE FWD",
      "make_model_trim_paths": [
        "m7/d292/LE FWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "LE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d531",
      "label": "Lincoln Town Car",
      "make_model_trim_paths": [
        "m38",
        "m38/d531"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d295",
      "label": "Toyota Corolla",
      "make_model_trim_paths": [
        "m7/d295",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d298",
      "label": "Toyota Highlander",
      "make_model_trim_paths": [
        "m7/d298",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid SE FWD",
      "make_model_trim_paths": [
        "m7/d2908/SE FWD",
        "m7",
        "m7/d2908"
      ],
      "trim_name": "SE FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d2908",
      "label": "Toyota Camry Hybrid FWD",
      "make_model_trim_paths": [
        "m7",
        "m7/d2908",
        "m7/d2908/FWD"
      ],
      "trim_name": "FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE Nightshade AWD",
      "make_model_trim_paths": [
        "m7/d292/SE Nightshade AWD",
        "m7/d292",
        "m7"
      ],
      "trim_name": "SE Nightshade AWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d293",
      "label": "Toyota Camry Solara 2 Dr SE",
      "make_model_trim_paths": [
        "m7",
        "m7/d293",
        "m7/d293/2 Dr SE"
      ],
      "trim_name": "2 Dr SE",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry SE Sport Limited Edition",
      "make_model_trim_paths": [
        "m7/d292",
        "m7",
        "m7/d292/SE Sport Limited Edition"
      ],
      "trim_name": "SE Sport Limited Edition",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry XSE V6 FWD",
      "make_model_trim_paths": [
        "m7/d292",
        "m7/d292/XSE V6 FWD",
        "m7"
      ],
      "trim_name": "XSE V6 FWD",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d290",
      "label": "Toyota 4Runner",
      "make_model_trim_paths": [
        "m7",
        "m7/d290"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d308",
      "label": "Toyota Sienna",
      "make_model_trim_paths": [
        "m7/d308",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d306",
      "label": "Toyota RAV4",
      "make_model_trim_paths": [
        "m7",
        "m7/d306"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d307",
      "label": "Toyota Sequoia",
      "make_model_trim_paths": [
        "m7",
        "m7/d307"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d15",
      "label": "Toyota Prius",
      "make_model_trim_paths": [
        "m7",
        "m7/d15"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d309",
      "label": "Toyota Supra",
      "make_model_trim_paths": [
        "m7",
        "m7/d309"
      ],
      "trim_name": null,
      "type": "MakeModel"
    },
    {
      "entity_id": "d292",
      "label": "Toyota Camry DX",
      "make_model_trim_paths": [
        "m7/d292",
        "m7",
        "m7/d292/DX"
      ],
      "trim_name": "DX",
      "type": "MakeModelTrim"
    },
    {
      "entity_id": "d299",
      "label": "Toyota Land Cruiser",
      "make_model_trim_paths": [
        "m7/d299",
        "m7"
      ],
      "trim_name": null,
      "type": "MakeModel"
    }
  ]
}
```
