Marketprice API

Documentation to get Marketprice details of the Ad.

Introduction

Overview

The EuroStocks Market price API is an interface to provide ads position and price on market level.

Documentation can be incomplete and/or outdated, Contact EuroStocks team by sending an email on [e-mail] for any questions regarding API.

The API is available at this base URL:

https://services.eurostocks.com

Main features

• Car Makes

• Car Models

• Car Categories

• Car FuelTypes

• Car Transmission

• MarketPrice

Prerequisites

Market Price API access can be granted to suppliers who wants to get ads market informations, and it requires username, password and API Key to access API.

Limited support for the development process and maintenance: Please note that all examples provided in our documentation are considered as guidelines for your development process but EuroStocks for itself is not able to directly assist with any of your preferred programming languages and/or used scripts.

Test Account

A test environment can be provided. Please ask for the test account details and all the information will be used as mention in Prerequisites on test API url https://test-services.eurostocks.com.

Working with Market Price API Data

Get a vehicle makes

GET https://services.eurostocks.com/api/v1/marketprice/vehicle/car/makes

Get detailed information about the car makes.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides
Password*	String	Password which EuroStocks provides

200: OK

{
    // Response
}

Sample Success Request

GET /api/v1/marketprice/vehicle/car/makes
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                                
{
  "Status": 200,
  "Message": "",
  "Result": [
    {
      "key": "ABARTH",
      "description": "Abarth"
    },
    {
      "key": "AC",
      "description": "AC"
    },
    {
      "key": "ACURA",
      "description": "Acura"
    },
    {
      "key": "AIXAM",
      "description": "Aixam"
    },
	...]
}

Get a car models

GET https://services.eurostocks.com/api/v1/marketprice/vehicle/car/models/{makeKey}

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
makeKey*	String	Make key to get its models

Sample Success Request

GET /api/v1/marketprice/vehicle/car/models/AUDI
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
{
  "Status": 200,
  "Message": "",
  "Result": [
    {
      "key": "100",
      "description": "100"
    },
    {
      "key": "200",
      "description": "200"
    },
    {
      "key": "80",
      "description": "80"
    },
    {
      "key": "90",
      "description": "90"
    },
	...]
}

Get a car categories

GET

Get detailed information about the car categories.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

200: OK

{
    // Response
}

Sample Success Request

GET /api/v1/marketprice/vehicle/car/categories
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                                
{
  "Status": 200,
  "Message": "",
  "Result": [
    {
      "Key": "Cabrio",
      "Description": "Cabriolet / Roadster"
    },
    {
      "Key": "EstateCar",
      "Description": "Estate Car"
    },
    {
      "Key": "OffRoad",
      "Description": "Off-road Vehicle/Pickup Truck"
    },
    {
      "Key": "Limousine",
      "Description": "Saloon"
    },
	...]
}

Get a car Fuel types

GET https://services.eurostocks.com/api/v1/marketprice/vehicle/car/fueltypes

Get detailed information about the car fuel types.

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provid

Sample Success Request

GET /api/v1/marketprice/vehicle/car/fueltypes
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                                
{
  "Status": 200,
  "Message": "",
  "Result": [
    {
      "Key": "DIESEL",
      "Description": "Diesel"
    },
    {
      "Key": "ELECTRICITY",
      "Description": "Electric"
    },
    {
      "Key": "ETHANOL",
      "Description": "Ethanol (FFV, E85, etc.)"
    },
	...]
}

Get a car transmissions

GET https://services.eurostocks.com/api/v1/marketprice/vehicle/car/transmissions

Get detailed information about the car transmissions.

Headers

Name	Type	Description
Header*	String	Username which EuroStocks provides
UserName*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Sample Success Request

GET /api/v1/marketprice/vehicle/car/transmissions
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
{
  "Status": 200,
  "Message": "",
  "Result": [
    {
      "Key": "AUTOMATIC_GEAR",
      "Description": "Automatic transmission"
    },
    {
      "Key": "MANUAL_GEAR",
      "Description": "Manual gearbox"
    },
    {
      "Key": "SEMIAUTOMATIC_GEAR",
      "Description": "Semi-automatic"
    }
  ]
}

Get a Marketprice details

POST https://services.eurostocks.com/api/v1/marketprice/marketprice

Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	ApiKey which EuroStocks provides

Request Body

Name	Type	Description
Make*	String	Get Car makes. (Required) Makes can be found from : https://services.eurostocks.com/api/v1/marketprice/vehicle/car/makes
Model*	String	Get Car models by Make. (Required) Models can be found from : https://services.eurostocks.com/api/v1/marketprice/vehicle/car/models/{makeKey}
Year*	String	Get market price details by passing registration year. (Required)
FuelType*	String	Get FuelType to find vehicle on market. (RGet FuelType to find vehicle on market. (Required) FuelTypes can be found from : https://services.eurostocks.com/api/v1/marketprice/vehicle/car/fueltypes
Mileage*	String	Get market price details by passing Mileage. (Required)
Transmission*	String	Get Transmission details to find vehicle on market. (Required) Transmissions can be found from : https://services.eurostocks.com/api/v1/marketprice/vehicle/car/transmissions
Category*	String	Get Category details to find vehicle on market. (Required) Categories can be found from : https://services.eurostocks.com/api/v1/marketprice/vehicle/car/categories
Power*	Number	Get market price details by passing Power. (Required)
SalesPrice	Number	Get market price details by passing SalesPrice. (Optional)

200: OK

{
    // Response
}

Sample Success Request

POST /api/v1/marketprice/marketprice
HOST: services.eurostocks.com
Content-type: "application/json"

{
  "Make": "AUDI",
  "Model": "A3",
  "Year": 2016,
  "FuelType": "PETROL",
  "Mileage": 1000,
  "Transmission": "SEMIAUTOMATIC_GEAR",
  "Category": "EstateCar",
  "Power": 100,
  "SalesPrice": 15000
}

Sample Success Response

HTTP/1.1 200 OK
						
{
  "Status": 200,
  "Message": "",
  "Result": {
    "MarketPrice": 21027,
    "MarketPosition": "1",
    "MarketResultCount": 13
  }
}