marketcheck_ruby_client 1.0.7
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/README.md +133 -0
- data/docs/Averages.md +13 -0
- data/docs/BaseListing.md +27 -0
- data/docs/Build.md +19 -0
- data/docs/Dealer.md +23 -0
- data/docs/DealerApi.md +230 -0
- data/docs/Error.md +9 -0
- data/docs/FacetItem.md +9 -0
- data/docs/FacetsApi.md +71 -0
- data/docs/GraphsApi.md +73 -0
- data/docs/HistoricalListing.md +19 -0
- data/docs/HistoryApi.md +65 -0
- data/docs/InventoryApi.md +113 -0
- data/docs/Listing.md +23 -0
- data/docs/ListingDebugAttributes.md +13 -0
- data/docs/ListingExtraAttributes.md +10 -0
- data/docs/ListingMedia.md +9 -0
- data/docs/ListingVDP.md +10 -0
- data/docs/ListingsApi.md +324 -0
- data/docs/Location.md +12 -0
- data/docs/MakeModel.md +9 -0
- data/docs/MarketAveragesApi.md +70 -0
- data/docs/MarketTrendsApi.md +72 -0
- data/docs/PlotPoint.md +14 -0
- data/docs/SearchResponse.md +9 -0
- data/docs/TrendPoint.md +12 -0
- data/docs/VINDecoderApi.md +59 -0
- data/git_push.sh +52 -0
- data/lib/marketcheck_ruby_client.rb +65 -0
- data/lib/swagger_client/api/dealer_api.rb +312 -0
- data/lib/swagger_client/api/facets_api.rb +105 -0
- data/lib/swagger_client/api/graphs_api.rb +108 -0
- data/lib/swagger_client/api/history_api.rb +95 -0
- data/lib/swagger_client/api/inventory_api.rb +155 -0
- data/lib/swagger_client/api/listings_api.rb +474 -0
- data/lib/swagger_client/api/market_averages_api.rb +102 -0
- data/lib/swagger_client/api/market_trends_api.rb +108 -0
- data/lib/swagger_client/api/vin_decoder_api.rb +89 -0
- data/lib/swagger_client/api_client.rb +332 -0
- data/lib/swagger_client/api_error.rb +36 -0
- data/lib/swagger_client/configuration.rb +163 -0
- data/lib/swagger_client/models/averages.rb +217 -0
- data/lib/swagger_client/models/base_listing.rb +370 -0
- data/lib/swagger_client/models/build.rb +284 -0
- data/lib/swagger_client/models/dealer.rb +329 -0
- data/lib/swagger_client/models/error.rb +173 -0
- data/lib/swagger_client/models/facet_item.rb +173 -0
- data/lib/swagger_client/models/historical_listing.rb +284 -0
- data/lib/swagger_client/models/listing.rb +327 -0
- data/lib/swagger_client/models/listing_debug_attributes.rb +217 -0
- data/lib/swagger_client/models/listing_extra_attributes.rb +188 -0
- data/lib/swagger_client/models/listing_media.rb +175 -0
- data/lib/swagger_client/models/listing_vdp.rb +185 -0
- data/lib/swagger_client/models/location.rb +207 -0
- data/lib/swagger_client/models/make_model.rb +171 -0
- data/lib/swagger_client/models/plot_point.rb +228 -0
- data/lib/swagger_client/models/search_response.rb +175 -0
- data/lib/swagger_client/models/trend_point.rb +206 -0
- data/lib/swagger_client/version.rb +15 -0
- data/marketcheck_ruby_client-1.0.6.gem +0 -0
- data/marketcheck_ruby_client.gemspec +32 -0
- data/spec/api/dealer_api_spec.rb +109 -0
- data/spec/api/facets_api_spec.rb +57 -0
- data/spec/api/graphs_api_spec.rb +58 -0
- data/spec/api/history_api_spec.rb +54 -0
- data/spec/api/inventory_api_spec.rb +70 -0
- data/spec/api/listings_api_spec.rb +148 -0
- data/spec/api/market_averages_api_spec.rb +57 -0
- data/spec/api/market_trends_api_spec.rb +57 -0
- data/spec/api/vin_decoder_api_spec.rb +52 -0
- data/spec/models/averages_spec.rb +96 -0
- data/spec/models/base_listing_spec.rb +236 -0
- data/spec/models/build_spec.rb +156 -0
- data/spec/models/dealer_spec.rb +196 -0
- data/spec/models/error_spec.rb +56 -0
- data/spec/models/facet_item_spec.rb +56 -0
- data/spec/models/historical_listing_spec.rb +156 -0
- data/spec/models/listing_debug_attributes_spec.rb +96 -0
- data/spec/models/listing_extra_attributes_spec.rb +66 -0
- data/spec/models/listing_media_spec.rb +56 -0
- data/spec/models/listing_spec.rb +196 -0
- data/spec/models/listing_vdp_spec.rb +66 -0
- data/spec/models/location_spec.rb +86 -0
- data/spec/models/make_model_spec.rb +56 -0
- data/spec/models/plot_point_spec.rb +106 -0
- data/spec/models/search_response_spec.rb +56 -0
- data/spec/models/trend_point_spec.rb +86 -0
- metadata +337 -0
data/docs/Error.md
ADDED
data/docs/FacetItem.md
ADDED
data/docs/FacetsApi.md
ADDED
@@ -0,0 +1,71 @@
|
|
1
|
+
# SwaggerClient::FacetsApi
|
2
|
+
|
3
|
+
All URIs are relative to *http://api.marketcheck.com/v1*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**get_facets**](FacetsApi.md#get_facets) | **GET** /facets | Facets
|
8
|
+
|
9
|
+
|
10
|
+
# **get_facets**
|
11
|
+
> Array<FacetItem> get_facets(api_key, fields, opts)
|
12
|
+
|
13
|
+
Facets
|
14
|
+
|
15
|
+
[Merged with the /search API - Please check the 'facets' parameter to the Search API above] Get the facets for the given simple filter criteria (by given VIN's basic specification, Or by Year, Make, Model, Trim criteria) and facet fields
|
16
|
+
|
17
|
+
### Example
|
18
|
+
```ruby
|
19
|
+
# load the gem
|
20
|
+
require 'marketcheck_ruby_client'
|
21
|
+
|
22
|
+
api_instance = SwaggerClient::FacetsApi.new
|
23
|
+
|
24
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
25
|
+
|
26
|
+
fields = "fields_example" # String | Comma separated list of fields to generate facets for. Supported fields are - year, make, model, trim, exterior_color, interior_color, drivetrain, vehicle_type, car_type, body_style, body_subtype, doors
|
27
|
+
|
28
|
+
opts = {
|
29
|
+
vin: "vin_example", # String | VIN as a reference to the type of car for which facets data is to be returned
|
30
|
+
year: "year_example", # String | Year of the car
|
31
|
+
make: "make_example", # String | Make of the car
|
32
|
+
model: "model_example", # String | Model of the Car
|
33
|
+
trim: "trim_example" # String | Trim of the Car
|
34
|
+
}
|
35
|
+
|
36
|
+
begin
|
37
|
+
#Facets
|
38
|
+
result = api_instance.get_facets(api_key, fields, opts)
|
39
|
+
p result
|
40
|
+
rescue SwaggerClient::ApiError => e
|
41
|
+
puts "Exception when calling FacetsApi->get_facets: #{e}"
|
42
|
+
end
|
43
|
+
```
|
44
|
+
|
45
|
+
### Parameters
|
46
|
+
|
47
|
+
Name | Type | Description | Notes
|
48
|
+
------------- | ------------- | ------------- | -------------
|
49
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
50
|
+
**fields** | **String**| Comma separated list of fields to generate facets for. Supported fields are - year, make, model, trim, exterior_color, interior_color, drivetrain, vehicle_type, car_type, body_style, body_subtype, doors |
|
51
|
+
**vin** | **String**| VIN as a reference to the type of car for which facets data is to be returned | [optional]
|
52
|
+
**year** | **String**| Year of the car | [optional]
|
53
|
+
**make** | **String**| Make of the car | [optional]
|
54
|
+
**model** | **String**| Model of the Car | [optional]
|
55
|
+
**trim** | **String**| Trim of the Car | [optional]
|
56
|
+
|
57
|
+
### Return type
|
58
|
+
|
59
|
+
[**Array<FacetItem>**](FacetItem.md)
|
60
|
+
|
61
|
+
### Authorization
|
62
|
+
|
63
|
+
No authorization required
|
64
|
+
|
65
|
+
### HTTP reuqest headers
|
66
|
+
|
67
|
+
- **Content-Type**: Not defined
|
68
|
+
- **Accept**: application/json
|
69
|
+
|
70
|
+
|
71
|
+
|
data/docs/GraphsApi.md
ADDED
@@ -0,0 +1,73 @@
|
|
1
|
+
# SwaggerClient::GraphsApi
|
2
|
+
|
3
|
+
All URIs are relative to *http://api.marketcheck.com/v1*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**get_price_miles_plot_data**](GraphsApi.md#get_price_miles_plot_data) | **GET** /plots | Price, Miles plots data for given criteria
|
8
|
+
|
9
|
+
|
10
|
+
# **get_price_miles_plot_data**
|
11
|
+
> Array<PlotPoint> get_price_miles_plot_data(api_key, car_type, opts)
|
12
|
+
|
13
|
+
Price, Miles plots data for given criteria
|
14
|
+
|
15
|
+
Get price, miles plot data for active cars matching the given VIN's basic specification or Year, Make, Model, Trim (Optional) criteria
|
16
|
+
|
17
|
+
### Example
|
18
|
+
```ruby
|
19
|
+
# load the gem
|
20
|
+
require 'marketcheck_ruby_client'
|
21
|
+
|
22
|
+
api_instance = SwaggerClient::GraphsApi.new
|
23
|
+
|
24
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
25
|
+
|
26
|
+
car_type = "car_type_example" # String | Car type to get the scatter plot data for
|
27
|
+
|
28
|
+
opts = {
|
29
|
+
vin: "vin_example", # String | VIN as a reference to the type of car for which plot data is to be returned
|
30
|
+
year: "year_example", # String | Year of the car
|
31
|
+
make: "make_example", # String | Make of the car
|
32
|
+
model: "model_example", # String | Model of the Car
|
33
|
+
trim: "trim_example", # String | Trim of the Car
|
34
|
+
rows: "rows_example" # String | Number of results to return. Default is 1000. Max is 10000
|
35
|
+
}
|
36
|
+
|
37
|
+
begin
|
38
|
+
#Price, Miles plots data for given criteria
|
39
|
+
result = api_instance.get_price_miles_plot_data(api_key, car_type, opts)
|
40
|
+
p result
|
41
|
+
rescue SwaggerClient::ApiError => e
|
42
|
+
puts "Exception when calling GraphsApi->get_price_miles_plot_data: #{e}"
|
43
|
+
end
|
44
|
+
```
|
45
|
+
|
46
|
+
### Parameters
|
47
|
+
|
48
|
+
Name | Type | Description | Notes
|
49
|
+
------------- | ------------- | ------------- | -------------
|
50
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
51
|
+
**car_type** | **String**| Car type to get the scatter plot data for |
|
52
|
+
**vin** | **String**| VIN as a reference to the type of car for which plot data is to be returned | [optional]
|
53
|
+
**year** | **String**| Year of the car | [optional]
|
54
|
+
**make** | **String**| Make of the car | [optional]
|
55
|
+
**model** | **String**| Model of the Car | [optional]
|
56
|
+
**trim** | **String**| Trim of the Car | [optional]
|
57
|
+
**rows** | **String**| Number of results to return. Default is 1000. Max is 10000 | [optional]
|
58
|
+
|
59
|
+
### Return type
|
60
|
+
|
61
|
+
[**Array<PlotPoint>**](PlotPoint.md)
|
62
|
+
|
63
|
+
### Authorization
|
64
|
+
|
65
|
+
No authorization required
|
66
|
+
|
67
|
+
### HTTP reuqest headers
|
68
|
+
|
69
|
+
- **Content-Type**: Not defined
|
70
|
+
- **Accept**: application/json
|
71
|
+
|
72
|
+
|
73
|
+
|
@@ -0,0 +1,19 @@
|
|
1
|
+
# SwaggerClient::HistoricalListing
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**id** | **String** | Unique identifier representing a specific listing from the Marketcheck database | [optional]
|
7
|
+
**price** | **String** | Asking price for the car | [optional]
|
8
|
+
**msrp** | **String** | MSRP for the car | [optional]
|
9
|
+
**miles** | **String** | Odometer reading / reported miles usage for the car | [optional]
|
10
|
+
**vdp_url** | **String** | Vehicle Details Page url of the specific car | [optional]
|
11
|
+
**seller_name** | **String** | Seller name of the listing from the Marketcheck database | [optional]
|
12
|
+
**scraped_at** | **Float** | Listing scraped at timestamp | [optional]
|
13
|
+
**last_seen_at** | **Float** | Listing last seen at (most recent) timestamp | [optional]
|
14
|
+
**source** | **String** | Source website for the listing | [optional]
|
15
|
+
**city** | **String** | City of the listing | [optional]
|
16
|
+
**state** | **String** | State of the listing | [optional]
|
17
|
+
**zip** | **String** | Zip of the listing | [optional]
|
18
|
+
|
19
|
+
|
data/docs/HistoryApi.md
ADDED
@@ -0,0 +1,65 @@
|
|
1
|
+
# SwaggerClient::HistoryApi
|
2
|
+
|
3
|
+
All URIs are relative to *http://api.marketcheck.com/v1*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**history**](HistoryApi.md#history) | **GET** /history/{vin} | Get a cars online listing history
|
8
|
+
|
9
|
+
|
10
|
+
# **history**
|
11
|
+
> Array<HistoricalListing> history(api_key, vin, opts)
|
12
|
+
|
13
|
+
Get a cars online listing history
|
14
|
+
|
15
|
+
The history API returns online listing history for a car identified by its VIN. History listings are sorted in the descending order of the listing date / last seen date
|
16
|
+
|
17
|
+
### Example
|
18
|
+
```ruby
|
19
|
+
# load the gem
|
20
|
+
require 'marketcheck_ruby_client'
|
21
|
+
|
22
|
+
api_instance = SwaggerClient::HistoryApi.new
|
23
|
+
|
24
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
25
|
+
|
26
|
+
vin = "vin_example" # String | The VIN to identify the car to fetch the listing history. Must be a valid 17 char VIN
|
27
|
+
|
28
|
+
opts = {
|
29
|
+
rows: 3.4, # Float | Number of results to return. Default is 10. Max is 50
|
30
|
+
page: 3.4 # Float | Page number to fetch the results for the given criteria. Default is 1.
|
31
|
+
}
|
32
|
+
|
33
|
+
begin
|
34
|
+
#Get a cars online listing history
|
35
|
+
result = api_instance.history(api_key, vin, opts)
|
36
|
+
p result
|
37
|
+
rescue SwaggerClient::ApiError => e
|
38
|
+
puts "Exception when calling HistoryApi->history: #{e}"
|
39
|
+
end
|
40
|
+
```
|
41
|
+
|
42
|
+
### Parameters
|
43
|
+
|
44
|
+
Name | Type | Description | Notes
|
45
|
+
------------- | ------------- | ------------- | -------------
|
46
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
47
|
+
**vin** | **String**| The VIN to identify the car to fetch the listing history. Must be a valid 17 char VIN |
|
48
|
+
**rows** | [**Float**](.md)| Number of results to return. Default is 10. Max is 50 | [optional]
|
49
|
+
**page** | [**Float**](.md)| Page number to fetch the results for the given criteria. Default is 1. | [optional]
|
50
|
+
|
51
|
+
### Return type
|
52
|
+
|
53
|
+
[**Array<HistoricalListing>**](HistoricalListing.md)
|
54
|
+
|
55
|
+
### Authorization
|
56
|
+
|
57
|
+
No authorization required
|
58
|
+
|
59
|
+
### HTTP reuqest headers
|
60
|
+
|
61
|
+
- **Content-Type**: Not defined
|
62
|
+
- **Accept**: application/json
|
63
|
+
|
64
|
+
|
65
|
+
|
@@ -0,0 +1,113 @@
|
|
1
|
+
# SwaggerClient::InventoryApi
|
2
|
+
|
3
|
+
All URIs are relative to *http://api.marketcheck.com/v1*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**get_dealer_active_inventory**](InventoryApi.md#get_dealer_active_inventory) | **GET** /dealer/{dealer_id}/active/inventory | Dealer inventory
|
8
|
+
[**get_dealer_historical_inventory**](InventoryApi.md#get_dealer_historical_inventory) | **GET** /dealer/{dealer_id}/historical/inventory | Dealer's historical inventory
|
9
|
+
|
10
|
+
|
11
|
+
# **get_dealer_active_inventory**
|
12
|
+
> BaseListing get_dealer_active_inventory(api_key, dealer_id, opts)
|
13
|
+
|
14
|
+
Dealer inventory
|
15
|
+
|
16
|
+
Get a dealer's currently active inventory
|
17
|
+
|
18
|
+
### Example
|
19
|
+
```ruby
|
20
|
+
# load the gem
|
21
|
+
require 'marketcheck_ruby_client'
|
22
|
+
|
23
|
+
api_instance = SwaggerClient::InventoryApi.new
|
24
|
+
|
25
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
26
|
+
|
27
|
+
dealer_id = "dealer_id_example" # String | Id representing the dealer to fetch the active inventory for
|
28
|
+
|
29
|
+
opts = {
|
30
|
+
rows: "rows_example", # String | Number of results to return. Default is 10. Max is 50
|
31
|
+
start: "start_example" # String | Page number to fetch the results for the given criteria. Default is 1. Pagination is allowed only till first 1000 results for the search and sort criteria. The page value can be only between 1 to 1000/rows
|
32
|
+
}
|
33
|
+
|
34
|
+
begin
|
35
|
+
#Dealer inventory
|
36
|
+
result = api_instance.get_dealer_active_inventory(api_key, dealer_id, opts)
|
37
|
+
p result
|
38
|
+
rescue SwaggerClient::ApiError => e
|
39
|
+
puts "Exception when calling InventoryApi->get_dealer_active_inventory: #{e}"
|
40
|
+
end
|
41
|
+
```
|
42
|
+
|
43
|
+
### Parameters
|
44
|
+
|
45
|
+
Name | Type | Description | Notes
|
46
|
+
------------- | ------------- | ------------- | -------------
|
47
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
48
|
+
**dealer_id** | **String**| Id representing the dealer to fetch the active inventory for |
|
49
|
+
**rows** | **String**| Number of results to return. Default is 10. Max is 50 | [optional]
|
50
|
+
**start** | **String**| Page number to fetch the results for the given criteria. Default is 1. Pagination is allowed only till first 1000 results for the search and sort criteria. The page value can be only between 1 to 1000/rows | [optional]
|
51
|
+
|
52
|
+
### Return type
|
53
|
+
|
54
|
+
[**BaseListing**](BaseListing.md)
|
55
|
+
|
56
|
+
### Authorization
|
57
|
+
|
58
|
+
No authorization required
|
59
|
+
|
60
|
+
### HTTP reuqest headers
|
61
|
+
|
62
|
+
- **Content-Type**: Not defined
|
63
|
+
- **Accept**: application/json
|
64
|
+
|
65
|
+
|
66
|
+
|
67
|
+
# **get_dealer_historical_inventory**
|
68
|
+
> BaseListing get_dealer_historical_inventory(dealer_id)
|
69
|
+
|
70
|
+
Dealer's historical inventory
|
71
|
+
|
72
|
+
[v1 : Not Implemented Yet] - Get a dealer's historical inventory
|
73
|
+
|
74
|
+
### Example
|
75
|
+
```ruby
|
76
|
+
# load the gem
|
77
|
+
require 'marketcheck_ruby_client'
|
78
|
+
|
79
|
+
api_instance = SwaggerClient::InventoryApi.new
|
80
|
+
|
81
|
+
dealer_id = "dealer_id_example" # String | Id representing the dealer to fetch the active inventory for
|
82
|
+
|
83
|
+
|
84
|
+
begin
|
85
|
+
#Dealer's historical inventory
|
86
|
+
result = api_instance.get_dealer_historical_inventory(dealer_id)
|
87
|
+
p result
|
88
|
+
rescue SwaggerClient::ApiError => e
|
89
|
+
puts "Exception when calling InventoryApi->get_dealer_historical_inventory: #{e}"
|
90
|
+
end
|
91
|
+
```
|
92
|
+
|
93
|
+
### Parameters
|
94
|
+
|
95
|
+
Name | Type | Description | Notes
|
96
|
+
------------- | ------------- | ------------- | -------------
|
97
|
+
**dealer_id** | **String**| Id representing the dealer to fetch the active inventory for |
|
98
|
+
|
99
|
+
### Return type
|
100
|
+
|
101
|
+
[**BaseListing**](BaseListing.md)
|
102
|
+
|
103
|
+
### Authorization
|
104
|
+
|
105
|
+
No authorization required
|
106
|
+
|
107
|
+
### HTTP reuqest headers
|
108
|
+
|
109
|
+
- **Content-Type**: Not defined
|
110
|
+
- **Accept**: application/json
|
111
|
+
|
112
|
+
|
113
|
+
|
data/docs/Listing.md
ADDED
@@ -0,0 +1,23 @@
|
|
1
|
+
# SwaggerClient::Listing
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**id** | **String** | Unique identifier representing a specific listing from the Marketcheck database | [optional]
|
7
|
+
**heading** | **String** | Listing heading | [optional]
|
8
|
+
**vin** | **String** | VIN for the car | [optional]
|
9
|
+
**stock_no** | **String** | Stock no of the car | [optional]
|
10
|
+
**price** | **String** | Asking price for the car | [optional]
|
11
|
+
**msrp** | **String** | MSRP for the car | [optional]
|
12
|
+
**miles** | **String** | Odometer reading / reported miles usage for the car | [optional]
|
13
|
+
**vdp_url** | **String** | Vehicle Details Page url of the specific car | [optional]
|
14
|
+
**source** | **String** | Source domain of the listing | [optional]
|
15
|
+
**is_certified** | **Integer** | Flag indicating whether the car is Certified | [optional]
|
16
|
+
**dom** | **Float** | Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car | [optional]
|
17
|
+
**build** | [**Build**](Build.md) | Build / Specifications attributes | [optional]
|
18
|
+
**media** | [**ListingMedia**](ListingMedia.md) | Car Media Attributes - main photo link/url and photo links | [optional]
|
19
|
+
**extra** | [**ListingExtraAttributes**](ListingExtraAttributes.md) | Extra attributes for the listing - options, features, seller comments etc | [optional]
|
20
|
+
**dealer** | [**Dealer**](Dealer.md) | | [optional]
|
21
|
+
**car_location** | [**Location**](Location.md) | Car location data. Included only if its a different location to the dealers location | [optional]
|
22
|
+
|
23
|
+
|
@@ -0,0 +1,13 @@
|
|
1
|
+
# SwaggerClient::ListingDebugAttributes
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**robot_id** | **Float** | Robot id | [optional]
|
7
|
+
**cycle_id** | **Float** | Cycle id | [optional]
|
8
|
+
**scraped_at** | **String** | Scraped date and time | [optional]
|
9
|
+
**template_id** | **Float** | Template id | [optional]
|
10
|
+
**user_id** | **Float** | User id | [optional]
|
11
|
+
**taxonomy_vin** | **String** | Taxonomy vin | [optional]
|
12
|
+
|
13
|
+
|
@@ -0,0 +1,10 @@
|
|
1
|
+
# SwaggerClient::ListingExtraAttributes
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**options** | **Array<String>** | Installed Options of the car | [optional]
|
7
|
+
**features** | **Array<String>** | List of Features available with the car | [optional]
|
8
|
+
**seller_comment** | **String** | Seller comment for the car | [optional]
|
9
|
+
|
10
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# SwaggerClient::ListingMedia
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**photo_link** | **String** | Single photo url of the car | [optional]
|
7
|
+
**photo_links** | **Array<String>** | A list of photo urls for the car | [optional]
|
8
|
+
|
9
|
+
|
data/docs/ListingVDP.md
ADDED
@@ -0,0 +1,10 @@
|
|
1
|
+
# SwaggerClient::ListingVDP
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**html** | **String** | The HTML string for the listing web page | [optional]
|
7
|
+
**crawled_at** | **Float** | The timestamp indicating the time when the VDP was cached | [optional]
|
8
|
+
**vdp_url** | **String** | The URL of the VDP | [optional]
|
9
|
+
|
10
|
+
|
data/docs/ListingsApi.md
ADDED
@@ -0,0 +1,324 @@
|
|
1
|
+
# SwaggerClient::ListingsApi
|
2
|
+
|
3
|
+
All URIs are relative to *http://api.marketcheck.com/v1*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**get_listing**](ListingsApi.md#get_listing) | **GET** /listing/{id} | Listing by id
|
8
|
+
[**get_listing_extra**](ListingsApi.md#get_listing_extra) | **GET** /listing/{id}/extra | Long text Listings attributes for Listing with the given id
|
9
|
+
[**get_listing_media**](ListingsApi.md#get_listing_media) | **GET** /listing/{id}/media | Listing media by id
|
10
|
+
[**get_listing_vdp**](ListingsApi.md#get_listing_vdp) | **GET** /listing/{id}/vdp | Get listing HTML
|
11
|
+
[**search**](ListingsApi.md#search) | **GET** /search | Gets active car listings for the given search criteria
|
12
|
+
|
13
|
+
|
14
|
+
# **get_listing**
|
15
|
+
> Listing get_listing(api_key, id)
|
16
|
+
|
17
|
+
Listing by id
|
18
|
+
|
19
|
+
Get a particular listing by its id
|
20
|
+
|
21
|
+
### Example
|
22
|
+
```ruby
|
23
|
+
# load the gem
|
24
|
+
require 'marketcheck_ruby_client'
|
25
|
+
|
26
|
+
api_instance = SwaggerClient::ListingsApi.new
|
27
|
+
|
28
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
29
|
+
|
30
|
+
id = "id_example" # String | Listing id to get all the listing attributes
|
31
|
+
|
32
|
+
|
33
|
+
begin
|
34
|
+
#Listing by id
|
35
|
+
result = api_instance.get_listing(api_key, id)
|
36
|
+
p result
|
37
|
+
rescue SwaggerClient::ApiError => e
|
38
|
+
puts "Exception when calling ListingsApi->get_listing: #{e}"
|
39
|
+
end
|
40
|
+
```
|
41
|
+
|
42
|
+
### Parameters
|
43
|
+
|
44
|
+
Name | Type | Description | Notes
|
45
|
+
------------- | ------------- | ------------- | -------------
|
46
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
47
|
+
**id** | **String**| Listing id to get all the listing attributes |
|
48
|
+
|
49
|
+
### Return type
|
50
|
+
|
51
|
+
[**Listing**](Listing.md)
|
52
|
+
|
53
|
+
### Authorization
|
54
|
+
|
55
|
+
No authorization required
|
56
|
+
|
57
|
+
### HTTP reuqest headers
|
58
|
+
|
59
|
+
- **Content-Type**: Not defined
|
60
|
+
- **Accept**: application/json
|
61
|
+
|
62
|
+
|
63
|
+
|
64
|
+
# **get_listing_extra**
|
65
|
+
> ListingExtraAttributes get_listing_extra(api_key, id)
|
66
|
+
|
67
|
+
Long text Listings attributes for Listing with the given id
|
68
|
+
|
69
|
+
Get listing options, features, seller comments
|
70
|
+
|
71
|
+
### Example
|
72
|
+
```ruby
|
73
|
+
# load the gem
|
74
|
+
require 'marketcheck_ruby_client'
|
75
|
+
|
76
|
+
api_instance = SwaggerClient::ListingsApi.new
|
77
|
+
|
78
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
79
|
+
|
80
|
+
id = "id_example" # String | Listing id to get all the long text listing attributes
|
81
|
+
|
82
|
+
|
83
|
+
begin
|
84
|
+
#Long text Listings attributes for Listing with the given id
|
85
|
+
result = api_instance.get_listing_extra(api_key, id)
|
86
|
+
p result
|
87
|
+
rescue SwaggerClient::ApiError => e
|
88
|
+
puts "Exception when calling ListingsApi->get_listing_extra: #{e}"
|
89
|
+
end
|
90
|
+
```
|
91
|
+
|
92
|
+
### Parameters
|
93
|
+
|
94
|
+
Name | Type | Description | Notes
|
95
|
+
------------- | ------------- | ------------- | -------------
|
96
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
97
|
+
**id** | **String**| Listing id to get all the long text listing attributes |
|
98
|
+
|
99
|
+
### Return type
|
100
|
+
|
101
|
+
[**ListingExtraAttributes**](ListingExtraAttributes.md)
|
102
|
+
|
103
|
+
### Authorization
|
104
|
+
|
105
|
+
No authorization required
|
106
|
+
|
107
|
+
### HTTP reuqest headers
|
108
|
+
|
109
|
+
- **Content-Type**: Not defined
|
110
|
+
- **Accept**: application/json
|
111
|
+
|
112
|
+
|
113
|
+
|
114
|
+
# **get_listing_media**
|
115
|
+
> ListingMedia get_listing_media(api_key, id)
|
116
|
+
|
117
|
+
Listing media by id
|
118
|
+
|
119
|
+
Get listing media (photo, photos) by id
|
120
|
+
|
121
|
+
### Example
|
122
|
+
```ruby
|
123
|
+
# load the gem
|
124
|
+
require 'marketcheck_ruby_client'
|
125
|
+
|
126
|
+
api_instance = SwaggerClient::ListingsApi.new
|
127
|
+
|
128
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
129
|
+
|
130
|
+
id = "id_example" # String | Listing id to get all the listing attributes
|
131
|
+
|
132
|
+
|
133
|
+
begin
|
134
|
+
#Listing media by id
|
135
|
+
result = api_instance.get_listing_media(api_key, id)
|
136
|
+
p result
|
137
|
+
rescue SwaggerClient::ApiError => e
|
138
|
+
puts "Exception when calling ListingsApi->get_listing_media: #{e}"
|
139
|
+
end
|
140
|
+
```
|
141
|
+
|
142
|
+
### Parameters
|
143
|
+
|
144
|
+
Name | Type | Description | Notes
|
145
|
+
------------- | ------------- | ------------- | -------------
|
146
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
147
|
+
**id** | **String**| Listing id to get all the listing attributes |
|
148
|
+
|
149
|
+
### Return type
|
150
|
+
|
151
|
+
[**ListingMedia**](ListingMedia.md)
|
152
|
+
|
153
|
+
### Authorization
|
154
|
+
|
155
|
+
No authorization required
|
156
|
+
|
157
|
+
### HTTP reuqest headers
|
158
|
+
|
159
|
+
- **Content-Type**: Not defined
|
160
|
+
- **Accept**: application/json
|
161
|
+
|
162
|
+
|
163
|
+
|
164
|
+
# **get_listing_vdp**
|
165
|
+
> ListingVDP get_listing_vdp(api_key, id)
|
166
|
+
|
167
|
+
Get listing HTML
|
168
|
+
|
169
|
+
Cached HTML of the Vehicle Details Page (VDP) for the listing. The HTML is cached only for 7 days for all listings. So this API could be used to get HTML of mostly active listings and that have recently expired
|
170
|
+
|
171
|
+
### Example
|
172
|
+
```ruby
|
173
|
+
# load the gem
|
174
|
+
require 'marketcheck_ruby_client'
|
175
|
+
|
176
|
+
api_instance = SwaggerClient::ListingsApi.new
|
177
|
+
|
178
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
179
|
+
|
180
|
+
id = "id_example" # String | Listing id to get the vehicle details page (VDP) HTML
|
181
|
+
|
182
|
+
|
183
|
+
begin
|
184
|
+
#Get listing HTML
|
185
|
+
result = api_instance.get_listing_vdp(api_key, id)
|
186
|
+
p result
|
187
|
+
rescue SwaggerClient::ApiError => e
|
188
|
+
puts "Exception when calling ListingsApi->get_listing_vdp: #{e}"
|
189
|
+
end
|
190
|
+
```
|
191
|
+
|
192
|
+
### Parameters
|
193
|
+
|
194
|
+
Name | Type | Description | Notes
|
195
|
+
------------- | ------------- | ------------- | -------------
|
196
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
197
|
+
**id** | **String**| Listing id to get the vehicle details page (VDP) HTML |
|
198
|
+
|
199
|
+
### Return type
|
200
|
+
|
201
|
+
[**ListingVDP**](ListingVDP.md)
|
202
|
+
|
203
|
+
### Authorization
|
204
|
+
|
205
|
+
No authorization required
|
206
|
+
|
207
|
+
### HTTP reuqest headers
|
208
|
+
|
209
|
+
- **Content-Type**: Not defined
|
210
|
+
- **Accept**: application/json
|
211
|
+
|
212
|
+
|
213
|
+
|
214
|
+
# **search**
|
215
|
+
> SearchResponse search(api_key, latitude, longitude, radius, car_type, opts)
|
216
|
+
|
217
|
+
Gets active car listings for the given search criteria
|
218
|
+
|
219
|
+
This endpoint is the meat of the API and serves many purposes. This API produces a list of currently active cars from the market for the given search criteria. The API results are limited to allow pagination upto 1000 rows. \n The search API facilitates the following use cases - \n1. Search Cars around a given geo-point within a given radius \n2. Search cars for a specific year / make / model or combination of these \n3. Search cars matching multiple year, make, model combinatins in the same search request\n4. Filter results by most car specification attributes\n5. Search for similar cars by VIN or Taxonomy VIN \n6. Filter cars within a given price / miles / days on market (dom) range\n7. Specify a sort order for the results on price / miles / dom / listed date \n8. Search cars for a given City / State combination \n9. Get Facets to build the search drill downs \n10. Get Market averages for price/miles/dom/msrp for your search
|
220
|
+
|
221
|
+
### Example
|
222
|
+
```ruby
|
223
|
+
# load the gem
|
224
|
+
require 'marketcheck_ruby_client'
|
225
|
+
|
226
|
+
api_instance = SwaggerClient::ListingsApi.new
|
227
|
+
|
228
|
+
api_key = "api_key_example" # String | The API Authentication Key. Mandatory with all API calls.
|
229
|
+
|
230
|
+
latitude = 1.2 # Float | Latitude component of location
|
231
|
+
|
232
|
+
longitude = 1.2 # Float | Longitude component of location
|
233
|
+
|
234
|
+
radius = 56 # Integer | Radius around the search location
|
235
|
+
|
236
|
+
car_type = "car_type_example" # String | Car type. Allowed values are - new / used / certified
|
237
|
+
|
238
|
+
opts = {
|
239
|
+
year: "year_example", # String | Car year - 1980 onwards. You can pass in multiple year separated by comma e.g. 2010,2011
|
240
|
+
make: "make_example", # String | Car Make - should be a standard OEM Make name
|
241
|
+
model: "model_example", # String | Car model to search
|
242
|
+
trim: "trim_example", # String | Car trim to search
|
243
|
+
dealer_id: "dealer_id_example", # String | Dealer id to filter the cars
|
244
|
+
body_type: "body_type_example", # String | Body type to filter the cars on
|
245
|
+
body_subtype: "body_subtype_example", # String | Body subtype to filter the cars on
|
246
|
+
vehicle_type: "vehicle_type_example", # String | Vehicle type to filter the cars on
|
247
|
+
vins: "vins_example", # String | Comma separated list of 17 digit vins to search the matching cars for. Only 10 VINs allowed per request. If the request contains more than 10 VINs the first 10 VINs will be considered. Could be used as a More Like This or Similar Vehicles search for the given VINs. Ths vins parameter is an alternative to taxonomy_vins or ymmt parameters available with the search API. vins and taxonomy_vins parameters could be used to filter our cars with the exact build represented by the vins or taxonomy_vins whereas ymmt is a top level filter that does not filter cars by the build attributes like doors, drivetrain, cylinders, body type, body subtype, vehicle type etc
|
248
|
+
taxonomy_vins: "taxonomy_vins_example", # String | Comma separated list of 10 letters excert from the 17 letter VIN. The 10 letters to be picked up from the 17 letter VIN are - first 8 letters and the 10th and 11th letter. E.g. For a VIN - 1FTFW1EF3EKE57182 the taxonomy vin would be - 1FTFW1EFEK A taxonomy VIN identified a build of a car and could be used to filter our cars of a particular build. This is an alternative to the vin or ymmt parameters to the search API.
|
249
|
+
ymmt: "ymmt_example", # String | Comma separated list of Year, Make, Model, Trim combinations. Each combination needs to have the year,make,model, trim values separated by a pipe '|' character in the form year|make|model|trim. e.g. 2010|Audi|A5,2014|Nissan|Sentra|S 6MT,|Honda|City| You could just provide strings of the form - 'year|make||' or 'year|make|model' or '|make|model|' combinations. Individual year / make / model filters provied with the API calls will take precedence over the Year, Make, Model, Trim combinations. The Make, Model, Trim values must be valid values as per the Marketcheck Vin Decoder. If you are using a separate vin decoder then look at using the 'vins' or 'taxonomy_vins' parameter to the search api instead the year|make|model|trim combinations.
|
250
|
+
cylinders: "cylinders_example", # String | Cylinders to filter the cars on
|
251
|
+
transmission: "transmission_example", # String | Transmission to filter the cars on. [a = Automatic, m = Manual]
|
252
|
+
drivetrain: "drivetrain_example", # String | Drivetrain to filter the cars on.
|
253
|
+
exterior_color: "exterior_color_example", # String | Exterior color to match
|
254
|
+
interior_color: "interior_color_example", # String | Interior color to match
|
255
|
+
miles_range: "miles_range_example", # String | Miles range to filter cars with miles in the given range. Range to be given in the format - min-max e.g. 1000-5000
|
256
|
+
price_range: "price_range_example", # String | Price range to filter cars with the price in the range given. Range to be given in the format - min-max e.g. 1000-5000
|
257
|
+
dom_range: "dom_range_example", # String | Days on Market range to filter cars with the DOM within the given range. Range to be given in the format - min-max e.g. 10-50
|
258
|
+
sort_by: "sort_by_example", # String | Sort by field - allowed fields are distance|price|miles|dom|age|posted_at|year. Default sort field is distance from the given point
|
259
|
+
sort_order: "sort_order_example", # String | Sort order - asc or desc. Default sort order is distance from a point.
|
260
|
+
rows: "rows_example", # String | Number of results to return. Default is 10. Max is 50
|
261
|
+
start: "start_example", # String | Page number to fetch the results for the given criteria. Default is 1. Pagination is allowed only till first 1000 results for the search and sort criteria. The page value can be only between 1 to 1000/rows
|
262
|
+
facets: "facets_example", # String | The comma separated list of fields for which facets are requested. Supported fields are - year, make, model, trim, vehicle_type, car_type, body_type, body_subtype, drivetrain, cylinders, transmission, exterior_color, interior_color. 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.
|
263
|
+
stats: "stats_example" # String | The list of fields for which stats need to be generated based on the matching listings for the search criteria. Allowed fields are - price, miles, msrp, dom 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.
|
264
|
+
}
|
265
|
+
|
266
|
+
begin
|
267
|
+
#Gets active car listings for the given search criteria
|
268
|
+
result = api_instance.search(api_key, latitude, longitude, radius, car_type, opts)
|
269
|
+
p result
|
270
|
+
rescue SwaggerClient::ApiError => e
|
271
|
+
puts "Exception when calling ListingsApi->search: #{e}"
|
272
|
+
end
|
273
|
+
```
|
274
|
+
|
275
|
+
### Parameters
|
276
|
+
|
277
|
+
Name | Type | Description | Notes
|
278
|
+
------------- | ------------- | ------------- | -------------
|
279
|
+
**api_key** | **String**| The API Authentication Key. Mandatory with all API calls. |
|
280
|
+
**latitude** | **Float**| Latitude component of location |
|
281
|
+
**longitude** | **Float**| Longitude component of location |
|
282
|
+
**radius** | [**Integer**](.md)| Radius around the search location |
|
283
|
+
**car_type** | **String**| Car type. Allowed values are - new / used / certified |
|
284
|
+
**year** | **String**| Car year - 1980 onwards. You can pass in multiple year separated by comma e.g. 2010,2011 | [optional]
|
285
|
+
**make** | **String**| Car Make - should be a standard OEM Make name | [optional]
|
286
|
+
**model** | **String**| Car model to search | [optional]
|
287
|
+
**trim** | **String**| Car trim to search | [optional]
|
288
|
+
**dealer_id** | **String**| Dealer id to filter the cars | [optional]
|
289
|
+
**body_type** | **String**| Body type to filter the cars on | [optional]
|
290
|
+
**body_subtype** | **String**| Body subtype to filter the cars on | [optional]
|
291
|
+
**vehicle_type** | **String**| Vehicle type to filter the cars on | [optional]
|
292
|
+
**vins** | **String**| Comma separated list of 17 digit vins to search the matching cars for. Only 10 VINs allowed per request. If the request contains more than 10 VINs the first 10 VINs will be considered. Could be used as a More Like This or Similar Vehicles search for the given VINs. Ths vins parameter is an alternative to taxonomy_vins or ymmt parameters available with the search API. vins and taxonomy_vins parameters could be used to filter our cars with the exact build represented by the vins or taxonomy_vins whereas ymmt is a top level filter that does not filter cars by the build attributes like doors, drivetrain, cylinders, body type, body subtype, vehicle type etc | [optional]
|
293
|
+
**taxonomy_vins** | **String**| Comma separated list of 10 letters excert from the 17 letter VIN. The 10 letters to be picked up from the 17 letter VIN are - first 8 letters and the 10th and 11th letter. E.g. For a VIN - 1FTFW1EF3EKE57182 the taxonomy vin would be - 1FTFW1EFEK A taxonomy VIN identified a build of a car and could be used to filter our cars of a particular build. This is an alternative to the vin or ymmt parameters to the search API. | [optional]
|
294
|
+
**ymmt** | **String**| Comma separated list of Year, Make, Model, Trim combinations. Each combination needs to have the year,make,model, trim values separated by a pipe '|' character in the form year|make|model|trim. e.g. 2010|Audi|A5,2014|Nissan|Sentra|S 6MT,|Honda|City| You could just provide strings of the form - 'year|make||' or 'year|make|model' or '|make|model|' combinations. Individual year / make / model filters provied with the API calls will take precedence over the Year, Make, Model, Trim combinations. The Make, Model, Trim values must be valid values as per the Marketcheck Vin Decoder. If you are using a separate vin decoder then look at using the 'vins' or 'taxonomy_vins' parameter to the search api instead the year|make|model|trim combinations. | [optional]
|
295
|
+
**cylinders** | **String**| Cylinders to filter the cars on | [optional]
|
296
|
+
**transmission** | **String**| Transmission to filter the cars on. [a = Automatic, m = Manual] | [optional]
|
297
|
+
**drivetrain** | **String**| Drivetrain to filter the cars on. | [optional]
|
298
|
+
**exterior_color** | **String**| Exterior color to match | [optional]
|
299
|
+
**interior_color** | **String**| Interior color to match | [optional]
|
300
|
+
**miles_range** | **String**| Miles range to filter cars with miles in the given range. Range to be given in the format - min-max e.g. 1000-5000 | [optional]
|
301
|
+
**price_range** | **String**| Price range to filter cars with the price in the range given. Range to be given in the format - min-max e.g. 1000-5000 | [optional]
|
302
|
+
**dom_range** | **String**| Days on Market range to filter cars with the DOM within the given range. Range to be given in the format - min-max e.g. 10-50 | [optional]
|
303
|
+
**sort_by** | **String**| Sort by field - allowed fields are distance|price|miles|dom|age|posted_at|year. Default sort field is distance from the given point | [optional]
|
304
|
+
**sort_order** | **String**| Sort order - asc or desc. Default sort order is distance from a point. | [optional]
|
305
|
+
**rows** | **String**| Number of results to return. Default is 10. Max is 50 | [optional]
|
306
|
+
**start** | **String**| Page number to fetch the results for the given criteria. Default is 1. Pagination is allowed only till first 1000 results for the search and sort criteria. The page value can be only between 1 to 1000/rows | [optional]
|
307
|
+
**facets** | **String**| The comma separated list of fields for which facets are requested. Supported fields are - year, make, model, trim, vehicle_type, car_type, body_type, body_subtype, drivetrain, cylinders, transmission, exterior_color, interior_color. 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. | [optional]
|
308
|
+
**stats** | **String**| The list of fields for which stats need to be generated based on the matching listings for the search criteria. Allowed fields are - price, miles, msrp, dom 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. | [optional]
|
309
|
+
|
310
|
+
### Return type
|
311
|
+
|
312
|
+
[**SearchResponse**](SearchResponse.md)
|
313
|
+
|
314
|
+
### Authorization
|
315
|
+
|
316
|
+
No authorization required
|
317
|
+
|
318
|
+
### HTTP reuqest headers
|
319
|
+
|
320
|
+
- **Content-Type**: Not defined
|
321
|
+
- **Accept**: application/json
|
322
|
+
|
323
|
+
|
324
|
+
|