> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /cargurus/listings/search

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

**Price:** 1 credit

**💡 AI Hint:** Search CarGurus car listings. makes is required (at least one). models (by name, e.g. ['RAV4']) is optional and requires exactly one make. Filter by stock_type, zip+distance, price_min/price_max, mileage_min/mileage_max, year_min/year_max, body_types, fuel_types, transmissions, drivetrains, engines, exterior/interior colors, seats, deal_ratings, vehicle_history, nhtsa_safety_min, seller_types, dealer_rating_min, seller_ids, days_on_market_max, mpg_min and boolean toggles. Sort by best_match/best_deal/price/mileage/distance/year/listing age. count is required.



## OpenAPI

````yaml /openapi-filtered.json post /api/cargurus/listings/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

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


        **Price:** 1 credit


        **💡 AI Hint:** Search CarGurus car listings. makes is required (at
        least one). models (by name, e.g. ['RAV4']) is optional and requires
        exactly one make. Filter by stock_type, zip+distance,
        price_min/price_max, mileage_min/mileage_max, year_min/year_max,
        body_types, fuel_types, transmissions, drivetrains, engines,
        exterior/interior colors, seats, deal_ratings, vehicle_history,
        nhtsa_safety_min, seller_types, dealer_rating_min, seller_ids,
        days_on_market_max, mpg_min and boolean toggles. Sort by
        best_match/best_deal/price/mileage/distance/year/listing age. count is
        required.
      operationId: __api_cargurus_listings_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargurusListingsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CargurusListing'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CargurusListingsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          description: Max scrapping execution timeout (in seconds)
          default: 300
        makes:
          items:
            $ref: '#/components/schemas/CargurusMake'
          type: array
          minItems: 1
          description: Vehicle makes to search
        models:
          items:
            type: string
          type: array
          description: >-
            Model names to restrict to (e.g. 'RAV4', 'Camry'); requires exactly
            one make
          default: []
        stock_type:
          $ref: '#/components/schemas/CargurusStockType'
          description: Inventory type
          default: used
        zip:
          anyOf:
            - type: string
              minLength: 3
            - type: 'null'
          description: Postal code to search around (best-effort)
        distance:
          type: integer
          maximum: 50000
          minimum: 1
          description: Search radius in miles around the location
          default: 50000
        price_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum price (USD)
        price_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum price (USD)
        mileage_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum mileage (miles)
        mileage_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum mileage (miles)
        year_min:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
          description: Minimum model year
        year_max:
          anyOf:
            - type: integer
              minimum: 1900
            - type: 'null'
          description: Maximum model year
        body_types:
          items:
            $ref: '#/components/schemas/CargurusBodyType'
          type: array
          description: Body styles to include
          default: []
        fuel_types:
          items:
            $ref: '#/components/schemas/CargurusFuelType'
          type: array
          description: Fuel types to include
          default: []
        transmissions:
          items:
            $ref: '#/components/schemas/CargurusTransmission'
          type: array
          description: Transmission types to include
          default: []
        drivetrains:
          items:
            $ref: '#/components/schemas/CargurusDrivetrain'
          type: array
          description: Drivetrain types to include
          default: []
        engines:
          items:
            $ref: '#/components/schemas/CargurusEngine'
          type: array
          description: Engine configurations to include
          default: []
        exterior_colors:
          items:
            $ref: '#/components/schemas/CargurusColor'
          type: array
          description: Exterior colors to include
          default: []
        interior_colors:
          items:
            $ref: '#/components/schemas/CargurusColor'
          type: array
          description: Interior colors to include
          default: []
        seats:
          items:
            $ref: '#/components/schemas/CargurusSeats'
          type: array
          description: Number of seats
          default: []
        deal_ratings:
          items:
            $ref: '#/components/schemas/CargurusDealRating'
          type: array
          description: Deal ratings to include
          default: []
        vehicle_history:
          items:
            $ref: '#/components/schemas/CargurusVehicleHistoryOption'
          type: array
          description: Vehicle history requirements
          default: []
        nhtsa_safety_min:
          anyOf:
            - $ref: '#/components/schemas/CargurusNhtsaSafety'
            - type: 'null'
          description: Minimum NHTSA overall safety rating
        seller_types:
          items:
            $ref: '#/components/schemas/CargurusSellerType'
          type: array
          description: Seller types to include
          default: []
        dealer_rating_min:
          anyOf:
            - $ref: '#/components/schemas/CargurusDealerRating'
            - type: 'null'
          description: Minimum average dealer rating
        seller_ids:
          items:
            type: string
          type: array
          description: Restrict to specific dealer ids
          default: []
        days_on_market_max:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Maximum days on market
        mpg_min:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Minimum combined fuel economy (MPG)
        only_with_photos:
          type: boolean
          description: Only listings that have photos
          default: false
        only_price_drops:
          type: boolean
          description: Only listings with a recent price drop
          default: false
        only_with_financing:
          type: boolean
          description: Only listings with online financing
          default: false
        only_fees_included:
          type: boolean
          description: Only listings that include dealer fees in the price
          default: false
        hide_salvage:
          type: boolean
          description: Hide listings with a salvage history
          default: false
        hide_fleet:
          type: boolean
          description: Hide fleet (rental or corporate) vehicles
          default: false
        sort:
          $ref: '#/components/schemas/CargurusSort'
          description: Sort order
          default: best_match
        count:
          type: integer
          minimum: 1
          description: Max number of results to return
      type: object
      required:
        - makes
        - count
    CargurusListing:
      properties:
        '@type':
          type: string
          default: CargurusListing
        id:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        vin:
          anyOf:
            - type: string
            - type: 'null'
        make:
          anyOf:
            - type: string
            - type: 'null'
        model:
          anyOf:
            - type: string
            - type: 'null'
        year:
          anyOf:
            - type: integer
            - type: 'null'
        trim:
          anyOf:
            - type: string
            - type: 'null'
        body_type:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        total_price:
          anyOf:
            - type: number
            - type: 'null'
        imv:
          anyOf:
            - type: number
            - type: 'null'
        deal_rating:
          anyOf:
            - type: string
            - type: 'null'
        deal_score:
          anyOf:
            - type: number
            - type: 'null'
        mileage:
          anyOf:
            - type: number
            - type: 'null'
        drivetrain:
          anyOf:
            - type: string
            - type: 'null'
        transmission:
          anyOf:
            - type: string
            - type: 'null'
        engine:
          anyOf:
            - type: string
            - type: 'null'
        doors:
          anyOf:
            - type: integer
            - type: 'null'
        exterior_color:
          anyOf:
            - type: string
            - type: 'null'
        interior_color:
          anyOf:
            - type: string
            - type: 'null'
        fuel_type:
          anyOf:
            - type: string
            - type: 'null'
        city_mpg:
          anyOf:
            - type: number
            - type: 'null'
        highway_mpg:
          anyOf:
            - type: number
            - type: 'null'
        combined_mpg:
          anyOf:
            - type: number
            - type: 'null'
        ev_battery:
          anyOf:
            - $ref: '#/components/schemas/CargurusEvBattery'
            - type: 'null'
        is_cpo:
          type: boolean
          default: false
        is_new:
          type: boolean
          default: false
        safety_rating:
          anyOf:
            - type: integer
            - type: 'null'
        days_on_market:
          anyOf:
            - type: integer
            - type: 'null'
        distance:
          anyOf:
            - type: number
            - type: 'null'
        stock_number:
          anyOf:
            - type: string
            - type: 'null'
        price_drop:
          anyOf:
            - type: number
            - type: 'null'
        original_price:
          anyOf:
            - type: number
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        image_count:
          anyOf:
            - type: integer
            - type: 'null'
        options:
          items:
            type: string
          type: array
          default: []
        seller_id:
          anyOf:
            - type: string
            - type: 'null'
        seller_name:
          anyOf:
            - type: string
            - type: 'null'
        seller_city:
          anyOf:
            - type: string
            - type: 'null'
        seller_state:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    CargurusMake:
      type: string
      enum:
        - acura
        - alfa_romeo
        - am_general
        - amc
        - aston_martin
        - auburn
        - audi
        - austin
        - austin_healey
        - bentley
        - bmw
        - bugatti
        - buick
        - cadillac
        - caterham
        - chevrolet
        - chrysler
        - citroen
        - daewoo
        - daihatsu
        - datsun
        - de_tomaso
        - delorean
        - desoto
        - dodge
        - durant
        - eagle
        - edsel
        - excalibur
        - ferrari
        - fiat
        - fisker
        - ford
        - freightliner
        - genesis
        - geo
        - ghia
        - gmc
        - graham
        - honda
        - hudson
        - hummer
        - hyundai
        - ineos
        - infiniti
        - intermeccanica
        - international_harvester
        - isuzu
        - jaguar
        - jeep
        - jensen
        - kaiser
        - karma
        - kia
        - koenigsegg
        - lada
        - lamborghini
        - lancia
        - land_rover
        - lexus
        - lincoln
        - lotus
        - lucid
        - maserati
        - maybach
        - mazda
        - mclaren
        - mercedes_benz
        - mercury
        - mg
        - mini
        - mitsubishi
        - mobility_ventures
        - morgan
        - morris
        - nash
        - nissan
        - oldsmobile
        - overland
        - packard
        - pagani
        - paige
        - panoz
        - peerless
        - peugeot
        - pininfarina
        - plymouth
        - polestar
        - pontiac
        - porsche
        - qvale
        - ram
        - renault
        - rivian
        - rolls_royce
        - rover
        - saab
        - saturn
        - scion
        - shelby
        - smart
        - ssc
        - studebaker
        - subaru
        - sunbeam
        - suzuki
        - tesla
        - toyota
        - triumph
        - vinfast
        - volkswagen
        - volvo
        - vpg
        - white
        - willys
    CargurusStockType:
      type: string
      enum:
        - used
        - new
        - certified
        - third_party_certified
    CargurusBodyType:
      type: string
      enum:
        - coupe
        - convertible
        - hatchback
        - minivan
        - pickup_truck
        - sedan
        - suv
        - van
        - wagon
    CargurusFuelType:
      type: string
      enum:
        - diesel
        - electric
        - gasoline
        - hybrid
        - cng
        - flex_fuel
        - biodiesel
        - propane
        - fuel_cell
    CargurusTransmission:
      type: string
      enum:
        - AUTOMATIC
        - MANUAL
    CargurusDrivetrain:
      type: string
      enum:
        - FOUR_WHEEL_DRIVE
        - FOUR_BY_TWO
        - REAR_WHEEL_DRIVE
        - ALL_WHEEL_DRIVE
        - FRONT_WHEEL_DRIVE
    CargurusEngine:
      type: string
      enum:
        - I4
        - I5
        - I6
        - V6
        - V8
        - V12
    CargurusColor:
      type: string
      enum:
        - BLACK
        - WHITE
        - GRAY
        - SILVER
        - BLUE
        - RED
        - GREEN
        - BROWN
        - GOLD
        - ORANGE
        - YELLOW
        - PURPLE
        - TEAL
        - PINK
        - UNKNOWN
    CargurusSeats:
      type: string
      enum:
        - TWO
        - FOUR
        - FIVE
        - SIX
        - SEVEN
        - AT_LEAST_EIGHT
    CargurusDealRating:
      type: string
      enum:
        - great_deal
        - good_deal
        - fair_deal
        - high_price
        - overpriced
        - no_price_analysis
        - uncertain
    CargurusVehicleHistoryOption:
      type: string
      enum:
        - CLEAN_TITLE
        - SINGLE_OWNER
        - NON_FLEET
        - LEMON_FREE
        - NO_THEFT_HISTORY
        - UNDAMAGED_FRAME
        - NON_SALVAGE
    CargurusNhtsaSafety:
      type: string
      enum:
        - '3'
        - '4'
        - '5'
    CargurusSellerType:
      type: string
      enum:
        - FRANCHISE_DEALER
        - PAYING_DEALER
    CargurusDealerRating:
      type: string
      enum:
        - ONE_STAR_AND_MORE
        - TWO_STAR_AND_MORE
        - THREE_STAR_AND_MORE
        - FOUR_STAR_AND_MORE
        - FIVE_STAR
    CargurusSort:
      type: string
      enum:
        - best_match
        - best_deal
        - price_low
        - price_high
        - mileage_low
        - mileage_high
        - distance
        - year_new
        - year_old
        - newest_listed
        - oldest_listed
    CargurusEvBattery:
      properties:
        '@type':
          type: string
          default: CargurusEvBattery
        capacity_kwh:
          anyOf:
            - type: number
            - type: 'null'
        range_mi:
          anyOf:
            - type: number
            - type: 'null'
        charge_time_240v_hr:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````