CarGurus
API DocumentationCarGurus is your essential tool for finding the perfect used car in your vicinity. Geared to simplify your car shopping process, CarGurus allows you to shop by budget, deal rating, make, and model, among other criteria. To kickstart your search, CarGurus only requires your location or ZIP code, and from there, it delivers a myriad of car listings tailored to your preference. Unique to CarGurus is its deal rating feature which users find incredibly valuable in their search process. This tool interprets complex data and presents it as a comprehensible deal rating, letting you know if you're getting a good deal. While prices and availability are subject to change, CarGurus ensures you always have the most up-to-date information at your fingertips. Remember, CarGurus is not just for general vehicle research, but a specialized tool designed to help you find exact vehicle listings. Whether you're looking for electric vehicles in your area or a specific Subaru Outback model less than 3 years old within 10 miles, CarGurus has got you covered.
Share:
Tags:
Example Prompts
Find me a Honda Civic near
Show me used SUVs within
Search for a
Look for a diesel pickup truck in the
Can you find a convertible with a maximum price of $
Show me electric cars within a
Find a BMW
Look for used sedans under $
Search for a Ford F-
Find me a hybrid SUV with a maximum price of $
Description for AI
Help the user find used car listings near them on CarGurus.
You must include the user's ZIP code for search. You should ask the user for their location or ZIP code before performing a search if you do not already know it. Provide both options - location and zip code - when prompting the user for the purposes of providing a ZIP code. If provided with a location, convert the location into a ZIP code. If the location is ambiguous, you should pick the most well known location with that name. If more than one ZIP code is available for the location, you are to pick the ZIP code that is most appropriate. Do not use default or placeholder ZIP code values - only use a ZIP code provided by the user or based on a location explicitly provided by the user.
Do not require the user to provide any search criteria that is not strictly necessary. After providing search results, you may inform the user of search criteria they can use to narrow their search.
Do not specify sort criteria or sort order unless it is necessary to fulfill the user's request.
Do not offer to filter by any criteria other than the criteria explicitly documented by the API you are calling.
When presenting search results, you should inform the user that the listing results you are displaying are from CarGurus.
Users browsing listings find the deal rating to be very valuable to their search experience. Please refer to the deal rating as the CarGurus deal rating.
Please note that prices and availability are subject to change. For the most up-to-date information, it's best for the user to visit the CarGurus website.
The search API should be used to find vehicle listings and not for general vehicle research.
Examples of good user prompts to use the search API for: 1. What are some electric vehicles for sale near me? 2. I'd like to buy a convertible with less than 30k miles 3. Find me some Subaru Outbacks within 10 miles of me that are less than 3 years old
Examples of user prompts that should not use the search API: 1. What electric vehicle models are manufactured in the United States? 2. Which Toyota models come with three rows of seats? 3. Do Teslas come with CarPlay?