Gets active RV listings for the given search criteria

GET

/search/rv/active

RV Search

This endpoint provides search on RV inventory. This API produces a list of currently active RV 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 -

Search RV around a given geo-point within a given radius

Search RV for a specific year / make / model or combination of these

Search RV matching multiple year, make, model combinatins in the same search request

Filter results by most RV specification attributes

Filter RV within a given price / miles range

Specify a sort order for the results on price / miles / listed date

Search RV for a given City / State combination

Get Facets to build the search drill downs

Get Market averages for price/miles for your search

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marketcheck-prod.apigee.net/v2/search/rv/active'

Response Example

200 - Example 1

{
    "facets": {},
    "listings": [
        {
            "build": {
                "area": "string",
                "class": "string",
                "engine": "string",
                "fuel_type": "string",
                "gvwr": "string",
                "length": "string",
                "made_in": "string",
                "make": "string",
                "model": "string",
                "sleeps": "string",
                "slideouts": "string",
                "transmission": "string",
                "year": 0
            },
            "dealer": {
                "city": "string",
                "country": "string",
                "county": "string",
                "dealer_type": "string",
                "dealership_group_name": "string",
                "id": 0,
                "latitude": "string",
                "longitude": "string",
                "msa_code": "string",
                "name": "string",
                "phone": "string",
                "seller_email": "string",
                "state": "string",
                "street": "string",
                "website": "string",
                "zip": "string"
            },
            "dist": 0,
            "dp_url": "string",
            "exterior_color": "string",
            "first_seen_at": 0,
            "first_seen_at_date": "string",
            "heading": "string",
            "id": "string",
            "interior_color": "string",
            "inventory_type": "string",
            "last_seen_at": 0,
            "last_seen_at_date": "string",
            "media": {
                "photo_links": [
                    "string"
                ],
                "photo_links_cached": [
                    "string"
                ]
            },
            "miles": 0,
            "msrp": 0,
            "price": 0,
            "scraped_at": 0,
            "scraped_at_date": "string",
            "seller_type": "string",
            "source": "string",
            "stock_no": "string",
            "vin": "string"
        }
    ],
    "num_found": 0,
    "range_facets": {},
    "stats": {}
}

Request

Query Params

api_key

string

optional

The API Authentication Key. Mandatory with all API calls.

price_range

string

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

miles_range

string

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

msrp_range

string

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

year_range

string

optional

Year range to filter listings with the year in the range given. Range to be given in the format - min-max e.g. 2019-2021

search_text

string

optional

To search a substring across entire document

latitude

number

optional

Latitude component of location

longitude

number

optional

Longitude component of location

radius

integer

optional

Radius around the search location (Unit - Miles)

year

string

optional

To filter listing on their year

make

string

optional

To filter listings on their make

model

string

optional

To filter listings on their model

model_o

string

optional

To filter listings on their model orig (as described on the webpage)

vin

string

optional

To filter listing on their VIN

inventory_type

string

optional

To filter listing on their condition. Either used or new

stock_no

string

optional

To filter listing on their stock number on lot

source

string

optional

To filter listing on their source

dealer_name

string

optional

Filter listings on dealer_name

dealer_id

string

optional

Dealer id to filter the listings.

exterior_color

string

optional

Exterior color to match. Valid filter values are those that our Search facets API returns for unique exterior colors. You can pass in multiple exterior color values comma separated

interior_color

string

optional

Interior color to match. Valid filter values are those that our Search facets API returns for unique interior colors. You can pass in multiple interior color values comma separated

engine

string

optional

To filter listing on their engine

fuel_type

string

optional

To filter listing on their fuel type

transmission

string

optional

To filter listing on their transmission

class

string

optional

Filter RV listings on class

state

string

optional

To filter listing on State in which they are listed

city

string

optional

To filter listing on City in which they are listed

zip

string

optional

To filter listing on ZIP around which they are listed

msa_code

string

optional

To filter listing on msa code in which they are listed

sort_by

string

optional

Sort by field. Default sort field is distance from the given point

sort_order

string

optional

Sort order - asc or desc. Default sort order is asc

rows

integer

optional

Number of results to return. Default is 10. Max is 50

start

integer

optional

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

facets

string

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.

range_facets

string

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.

facet_sort

string

optional

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

stats

string

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.

last_seen_range

string

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

first_seen_range

string

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

last_seen_days

string

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

first_seen_days

string

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

slideouts

string

optional

Filter RV listings on slideouts

length_range

string

optional

length range to filter listings with the length in the range given. Range to be given in the format - min-max e.g. 50-200

length

string

optional

Filter RV listings on length

base_exterior_color

string

optional

Base exterior color to match. Valid filter values are those that our Search facets API returns for unique base exterior colors. You can pass in multiple base interior color values comma separated

base_interior_color

string

optional

Base interior color to match. Valid filter values are those that our Search facets API returns for unique base interior colors. You can pass in multiple base interior color values comma separated

seating_capacity

string

optional

To filter on vehicle seating capacity

fresh_water_capacity

string

optional

To filter on fresh water capacity of vehicle

sleeps

string

optional

To filter data based on sleeps

cylinders

string

optional

To filter listing on their cylinders

number_of_awnings

string

optional

To filter on number_of_awnings

doors

string

optional

Doors to filter the cars on. Valid filter values are those that our Search facets API returns for unique doors. You can pass in multiple doors values comma separated

gvwr

string

optional

To filter on the maximum total weight of your vehicle

Responses

🟢200List of all RV listings matching the search & filter criteria

application/json

Body

RV search query response

facets

object

optional

listings

array[object (RVBaseListing) {23}]

optional

build

object (RVBuild)

optional

Describes the RV specification

dealer

object (NestDealer)

optional

dist

number <double>

optional

Distance of the RV's location from the specified user lcoation

dp_url

string

optional

Details Page url of the specific RV

exterior_color

string

optional

Exterior color of the RV

first_seen_at

integer

optional

Listing first seen at first scraped timestamp

first_seen_at_date

string

optional

Listing first seen at first scraped date

heading

string

optional

Listing title as displayed on the source website

string

optional

Unique identifier representing a specific listing from the Marketcheck database

interior_color

string

optional

Interior color of the RV

inventory_type

string

optional

Inventory type of RV

last_seen_at

integer

optional

Listing last seen at (most recent) timestamp

last_seen_at_date

string

optional

Listing last seen at (most recent) date

media

object (ListingNestMedia)

optional

miles

integer

optional

Odometer reading / reported miles usage for the RV

msrp

integer

optional

MSRP for the RV

price

integer

optional

Asking price for the RV

scraped_at

number

optional

Listing last seen at date timestamp

scraped_at_date

string

optional

Listing last seen at date

seller_type

string

optional

Seller type for the RV

source

string

optional

Source domain of the listing

stock_no

string

optional

Stock number of RV in dealers inventory

vin

string

optional

VIN for the RV

num_found

integer

optional

The number of listings found

range_facets

object

optional

stats

object

optional

🔴500Error

Modified at 2023-08-15 07:36:55

Listing media by id

API for auto-completion of inputs