GET /search/motorcycle/active
Operation ID: —
Auth: api_key
Description
This endpoint provides search on motorcycle inventory. This API produces a list of currently active motorcycles from the market for the given search criteria. The API results are limited to allow pagination upto 5000 rows. The search API facilitates the following use cases - 1. Search motorcycles around a given geo-point within a given radius 2. Search motorcycles for a specific year / make / model or combination of these 3. Search motorcycles matching multiple year, make, model combinatins in the same search request 4. Filter results by most motorcycle specification attributes 5. Search for similar motorcycles by VIN or Taxonomy VIN 6. Filter motorcycles within a given price / miles range 7. Specify a sort order for the results on price / miles / listed date 8. Search motorcycles for a given City / State combination 9. Get Facets to build the search drill downs 10. Get Market averages for price/miles for your search
Parameters (42)
(string, query, optional)
The API Authentication Key. Mandatory with all API calls.
(string, query, optional)
To filter listing on their body type
(string, query, optional)
To filter listing on City in which they are listed
(string, query, optional)
Color of the vehicle
(string, query, optional)
To filter listing on their cylinders
(string, query, optional)
Dealer id to filter the listings.
(string, query, optional)
To filter listing on their drivetrain
(string, query, optional)
To filter listing on their engine
(string, query, optional, default: count)
Control sort order of facets with this parameter with default sort being on count, Other available sort is alphabetical sort, which can be obtained by using index as value for this param
Constraints: {'enum': ['count', 'index']}
(string, query, optional)
The comma separated list of fields for which facets are requested. Facets could be requested in addition to the listings for the search. Please note - The API calls with lots of facet fields may take longer to respond.
(string, query, optional)
First seen days range to filter listings with the first seen in the range given. Range to be given in the format - min-max e.g. 25-12
(string, query, optional)
First seen date range to filter listings with the first seen in the range given. Range to be given in the format [YYYYMMDD] - min-max e.g. 20190523-20190623
(string, query, optional)
To filter listing on their fuel type
(string, query, optional)
To filter listing on their condition. Either used or new
Constraints: {'enum': ['used', 'new']}
(string, query, optional)
Last seen days range to filter listings with the last seen in the range given. Range to be given in the format - min-max e.g. 25-12
(string, query, optional)
Last seen date range to filter listings with the last seen in the range given. Range to be given in the format [YYYYMMDD] - min-max e.g. 20190523-20190623
(number, query, optional)
Latitude component of location
(number, query, optional)
Longitude component of location
(string, query, optional)
To filter listings on their make
(string, query, optional)
Miles range to filter listings with miles in the given range. Range to be given in the format - min-max e.g. 1000-5000
(string, query, optional)
To filter listings on their model
(string, query, optional)
To filter listing on msa code in which they are listed
(string, query, optional)
MSRP range to filter listings with the msrp in the range given. Range to be given in the format - min-max e.g. 1000-5000
(string, query, optional)
Price range to filter listings with the price in the range given. Range to be given in the format - min-max e.g. 1000-5000
(integer, query, optional)
Radius around the search location (Unit - Miles)
Constraints: {'minimum': 0, 'maximum': 7000}
(string, query, optional)
The comma separated list of numeric fields for which range facets are requested. Range facets could be requested in addition to the listings for the search. Please note - The API calls with lots of range facet fields may take longer to respond.
(integer, query, optional, default: 10)
Number of results to return. Default is 10. Max is 50
Constraints: {'minimum': 0}
(string, query, optional)
To search a substring across entire document
(string, query, optional)
Sort by field. Default sort field is distance from the given point
(string, query, optional)
Sort order - asc or desc. Default sort order is asc
Constraints: {'enum': ['asc', 'desc', 'ASC', 'DESC']}
(string, query, optional)
To filter listing on their source
(integer, query, optional, default: 0)
Page number to fetch the results for the given criteria. Default is 0. Pagination is allowed only till first 10000 results for the search and sort criteria. The page value can be only between 1 to 10000/rows
Constraints: {'minimum': 0}
(string, query, optional)
To filter listing on State in which they are listed
(string, query, optional)
The list of fields for which stats need to be generated based on the matching listings for the search criteria. The stats consists of mean, max, average and count of listings based on which the stats are calculated for the field. Stats could be requested in addition to the listings for the search. Please note - The API calls with the stats fields may take longer to respond.
(string, query, optional)
To filter listing on their stock number on lot
(string, query, optional)
Taxonomy VIN of the motorcycle
(string, query, optional)
To filter listing on their transmission
(string, query, optional)
To filter listing on their trim
(string, query, optional)
To filter listing on their vehicle type
(string, query, optional)
To filter listing on their VIN
(string, query, optional)
To filter listing on their year
Constraints: {'minLength': 4}
(string, query, optional)
To filter listing on ZIP around which they are listed
No probe data for this endpoint yet.