Data API

Introduction

Overview

The EuroStocks Data Supplier API is an interface to provide Product and Vehicles from EuroStocks database and make them available to third parties.

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

The API is available at this base URL:

https://data-api.eurostocks.com

Main features

  • Search Products and Vehicles

  • Product details

  • Vehicle details

Prerequisites

Data supplier API access can be granted to suppliers who wants to read EuroStocks Product and Vehicle informations, and it required 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-data-api.eurostocks.com.

Search Products and Vehicles

POST https://data-api.eurostocks.com/api/v1/Search/list

Method will return product and vehicles based on the filter in request.

Headers

Name
Type
Description

UserName*

String

Username which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Password*

String

Password which EuroStocks provides

Request Body

Name
Type
Description

Type

String

Search by Types of Product or Vehicle. Click to read details about Types. Optional Parameter.

SubCategory

String

Search by Sub Categories of Product or Vehicle. Click to read details about Sub Categories. Optional Parameter.

LanguageIsoCode

String

Search Product or Vehicle by languages using LanguageIsoCode. Click to read details about LanguageIsoCodes. Mandatory Parameter.

PageSize

String

PageSize is no. of records on single page. Minimun PageSize is 1 and Maximum PageSize is 100. Mandatory Parameter.

SortOn

String

SortOn is used to get result based on different sorting options. Click to read details about SortOn options. Mandatory Parameter.

MainCategory

String

Search by Main Category of Product or Vehicle. Click to read details about Main Categories. Optional Parameter.

ResultType

String

Search Product or Vehicle by ResultType. This will use to filter if we want data for Vehicles, Products or Both Click to read details about ResultType. Mandatory Parameter.

PageNumber

String

No. of the page for which we want details. Mandatory Parameter.

SortOrder

String

Sorting can be in 'desc' or 'asc' order. Mandatory Parameter.

Sample Success Request

Sample Success Response

Product details

GET https://data-api.eurostocks.com/api/v1/product/detail/{productId}/{languageIsoCode}

Method will return product details by ProductId.

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

productId

String

ProductId is used to get products entire details. you can find product id using Search API with "Id" field. Mandatory Parameter.

languageIsoCode

String

Product details using LanguageIsoCode. Click to read details about LanguageIsoCodes. Mandatory Parameter.

Sample Success Request

Sample Success Response

Vehicle details

GET https://data-api.eurostocks.com/api/v1/vehicle/detail/{vehicleId}/{languageIsoCode}

Method will return vehicle details by ProductId.

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

vehicleId

String

VehicleId is used to get vehicles entire details. you can find vehicle id using Search API with "Id" field. Mandatory Parameter.

languageIsoCode

String

Product details using LanguageIsoCode. Click to read details about LanguageIsoCodes. Mandatory Parameter.

Sample Success Request

Sample Success Response

List of Main Categories

GET https://services.eurostocks.com/api/v1/category/mainCategories/{languageIsoCode}

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

*

Number

Get Main Category names language wise

Main Category Response Explanation

Parameter
Description

Parameter

Description

Key

Key will be used when we try to search products or vehicles with main category

Description

Used for the main category understanding

IsVehicleCategory

IsVehicleCategory is let user know that category which they are using is belongs to Product or Vehicle. It will also help user to know which API they need to use to get product or vehicle details.

Sample Success Request and Response

List of Sub Categories

GET https://data-api.eurostocks.com/api/v1/category/subCategories/{mainCategory}/{languageIsoCode}

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

mainCategory*

String

Get list of Sub Categories based on Main Category

languageIsoCode

String

Get Sub Category names language wise

Sample Success Request and Response

List of Types

GET https://data-api.eurostocks.com/api/v1/category/types/{subCategory}/{languageIsoCode}

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

subCategory*

String

Get list of types based on Sub Category

languageIsoCode

String

Get Sub Category names language wise

Sample Success Request and Response

List of available Languages

GET https://data-api.eurostocks.com/api/v1/languages

List of available languages using which user can retrieve details

Headers

Name
Type
Description

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Sample Success Request and Response

List of SortOn Values

GET https://data-api.eurostocks.com/api/v1/Search/SortOn

Headers

Name
Type
Description

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Sample Success Request and Response

List of Result Types Values

GET https://data-api.eurostocks.com/api/v1/Search/SortOn

Headers

Name
Type
Description

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Sample Success Request and Response

PreviousVehicle Data APINextLicense Plate API

Last updated