Find Your Perfect Car on CarGurus - Shop by Budget, Deal Rating, Make, Model, & More.
This plugin allows users to search for nearby used car listings on CarGurus based on their budget, make, and model. The user needs to provide their ZIP code to perform the search. The plugin provides search results along with the CarGurus deal rating, which is helpful for browsing listings. It also provides search criteria that can be used to narrow down the search results. The plugin does not require any search criteria other than a ZIP code or location and only filters by criteria documented by the CarGurus API. Note that prices and availability are subject to change, so it's best to visit the CarGurus website for up-to-date information.
Learn how to use CarGurus effectively! Here are a few example prompts, tips, and the documentation of available commands.
Example prompts
- Prompt 1: "What electric vehicles are available for sale near me?"
- Prompt 2: "Do you have any used convertibles with low mileage?"
- Prompt 3: "Find Subaru Outbacks within 10 miles that are less than 3 years old."
Features and commands
Feature/Command | Description |
---|
listingSearch | This command allows you to search for active vehicle listings based on provided search criteria. You must include the user's ZIP code for the search. The command supports various search criteria such as make name, model name, body style, maximum mileage, minimum/maximum price, minimum/maximum model year, fuel types, and sort criteria. The response includes the total number of listings found, as well as a list of individual listings with details such as listing ID, title, URL, mileage, price, deal rating, dealer name, dealer location, and listing distance from the user's location. The search results are based on the CarGurus website. It is recommended to visit the CarGurus website for the most up-to-date information regarding prices and availability. |
For AI
Namecargurus
DescriptionHelp 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?
Updates
First added26 June 2023