Manufacturer, model, vehicle facet search
This request allows you to call and limit vehicle results by manufacturer, model, year and/or salesname. Vehicle results are available after a specific manufacturer, model and year is requested or manufacturer, model and salesname is requested. The full list of all manufacturers and their models are in the response body.
Query URL
https://onedb.tecalliance.cn/api/vehicles/chinaid
Step 1: Fetch a list of all manufacturer with the total number of vehicles.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| includeManufacturerFacet | boolean | Yes | true | This request will build the manufacturer facet. |
JSON Input
{
"includeManufacturerFacet": true
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 219,
"data": [
{
"manuName": "Alpina",
"total": 3
},
{
"manuName": "Fisker",
"total": 2
},
{
"manuName": "GMC",
"total": 203
},
{
"manuName": "Jeep(进口)",
"total": 523
},
{
"manuName": "KTM",
"total": 2
},
{
"manuName": "MINI",
"total": 500
},
{
"manuName": "Smart",
"total": 250
},
......
......
......
......
]
},
"modelFacet": {
"total": 0,
"data": null
},
"yearFacet": null,
"salesNameFacet": {
"total": 0,
"data": null
}
}
Step 2: Fetch a list of all models for a specific manufacturer. The models will include the number of vehicles in the market.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| manuName | String | Yes | MINI | This is the name of the manufacturer in the response above. |
| includeManufacturerFacet | boolean | No | true | This request will build the manufacturer facet. |
| includeModelFacet | boolean | Yes | true | This request will build the model facet. |
JSON Input
{
"manuName": "MINI",
"includeManufacturerFacet": true,
"includeModelFacet": true
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 500
}
]
},
"modelFacet": {
"total": 8,
"data": [
{
"modelName": "Cabrio",
"total": 54
},
{
"modelName": "Clubman",
"total": 94
},
{
"modelName": "Countryman",
"total": 105
},
{
"modelName": "Coupe",
"total": 15
},
{
"modelName": "Mini",
"total": 159
},
{
"modelName": "Mini 5-Door",
"total": 52
},
{
"modelName": "Paceman",
"total": 16
},
{
"modelName": "Roadster",
"total": 5
}
]
},
"yearFacet": null,
"salesNameFacet": {
"total": 0,
"data": null
}
}
Step 3: Limit results to search for all available model years and salesname definition from a specific vehicle model.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| manuName | String | Yes | MINI | This is the name of the manufacturer in the response above. |
| modelName | String | Yes | Countryman | This is the name of the model in the response of the second step. |
| includeManufacturerFacet | boolean | No | true | This request will build the manufacturer facet. |
| includeModelFacet | boolean | No | true | This request will build the model facet. |
| includeYearFacet | boolean | No, if includeSalesNameFacet is used | true | This request will build the model year facet. |
| includeSalesNameFacet | boolean | No, if includeYearFacet is used. | true | This request will build the salesname facet. |
JSON Input
{
"manuName": "MINI",
"modelName": "Countryman",
"includeManufacturerFacet": true,
"includeModelFacet": true,
"includeYearFacet": true,
"includeSalesNameFacet": true
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 105
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelName": "Countryman",
"total": 105
}
]
},
"yearFacet": [
{
"count": 3,
"year": 2010
},
{
"count": 4,
"year": 2015
},
{
"count": 2,
"year": 2012
},
{
"count": 18,
"year": 2016
},
{
"count": 8,
"year": 2013
},
{
"count": 10,
"year": 2011
},
{
"count": 16,
"year": 2014
},
{
"count": 26,
"year": 2017
},
{
"count": 18,
"year": 2018
}
],
"salesNameFacet": {
"total": 33,
"data": [
{
"salesName": "1.5T 手自一体",
"total": 4
},
{
"salesName": "1.5T 手自一体 探险家",
"total": 4
},
{
"salesName": "1.5T 手自一体 旅行家",
"total": 2
},
{
"salesName": "1.5T 手自一体 特别版",
"total": 2
},
{
"salesName": "1.5T 手自一体 经典派",
"total": 4
},
{
"salesName": "1.5T 手自一体 艺术家",
"total": 4
},
{
"salesName": "1.5T 手自一体 赛车手",
"total": 2
},
{
"salesName": "1.5T 手自一体 非常假日版 英伦绿",
"total": 2
},
{
"salesName": "1.5T 手自一体 非常假日版 辣椒红",
"total": 2
},
{
"salesName": "1.6L 手自一体",
"total": 8
},
{
"salesName": "1.6L 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6L 手自一体 Excitement ",
"total": 2
},
{
"salesName": "1.6L 手自一体 Fun",
"total": 4
},
{
"salesName": "1.6L 手自一体 Fun ",
"total": 2
},
{
"salesName": "1.6T 手动",
"total": 1
},
{
"salesName": "1.6T 手动 柴油版",
"total": 1
},
{
"salesName": "1.6T 手自一体",
"total": 17
},
{
"salesName": "1.6T 手自一体 Excitement",
"total": 4
},
{
"salesName": "1.6T 手自一体 Excitement 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 Fun",
"total": 4
},
{
"salesName": "1.6T 手自一体 Fun 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 Park Lane",
"total": 4
},
{
"salesName": "1.6T 手自一体 极致暗夜版",
"total": 2
},
{
"salesName": "1.6T 手自一体 滑雪板",
"total": 2
},
{
"salesName": "1.6T 手自一体 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 进藏限量版",
"total": 2
},
{
"salesName": "2.0T 手自一体",
"total": 4
},
{
"salesName": "2.0T 手自一体 探险家",
"total": 2
},
{
"salesName": "2.0T 手自一体 旅行家",
"total": 4
},
{
"salesName": "2.0T 手自一体 经典派",
"total": 2
},
{
"salesName": "2.0T 手自一体 艺术家",
"total": 2
},
{
"salesName": "2.0T 手自一体 赛车手",
"total": 2
},
{
"salesName": "2.0T 手自一体 赛车控",
"total": 2
}
]
}
}
Step 4: Get all available vehicles for a manufacturer > model > year or manufacturer > model > salesname combination. It is possible to split number of vehicles into multiple requests.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| manuName | String | Yes | MINI | This is the name of the manufacturer. |
| modelName | String | Yes | Countryman | This is the name of the model. |
| year | Integer | No, if salesname is added. | 2014 | This is the model year in the response of the previous step. |
| salesName | String | No, if year is added. | 1.6L 手自一体 Excitement | This is the salesName in the response of the previous step. |
| includeManufacturerFacet | boolean | No | true | This request will build the manufacturer facet. |
| includeModelFacet | boolean | No | true | This request will build the model facet. |
| includeYearFacet | boolean | No | true | This request will build the model year facet. |
| includeSalesNameFacet | boolean | No | true | This request will build the salesname facet. |
| perpage | Integer | No | 50 | The number of vehicles in the response body per request. |
| page | Integer | No | 1 | The page to visit if the total number is larger than the number of vehicles per page. |
JSON Input
{
"manuName": "MINI",
"modelName": "Countryman",
"year": 2014,
"page": 1,
"perpage": 10,
"includeManufacturerFacet": true,
"includeModelFacet": true,
"includeYearFacet": true,
"includeSalesNameFacet": true
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
{
"totalMatching": 16,
"maxAllowedPage": 2,
"vehicles": [
{
"shortId": "MM05003116D0003",
"modelId": "MM05003116D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 105656,
"tecId": "TEC000670",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman",
"salesName": "1.6L 手自一体 Excitement",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "120",
"maximumOutputKw": "88",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003116D0004",
"modelId": "MM05003116D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 105656,
"tecId": "TEC000694",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman",
"salesName": "1.6L 手自一体 Fun",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "120",
"maximumOutputKw": "88",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003016D0005",
"modelId": "MM05003016D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 108611,
"tecId": "TEC000677",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman All 4",
"salesName": "1.6T 手自一体 Excitement",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "122",
"maximumOutputKw": "90",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003016D0004",
"modelId": "MM05003016D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 108611,
"tecId": "TEC000698",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman All 4",
"salesName": "1.6T 手自一体 Fun",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "122",
"maximumOutputKw": "90",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002716D0002",
"modelId": "MM05002716D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 56172,
"tecId": "TEC000640",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "JCW Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16C",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "218",
"maximumOutputKw": "160",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002916D0002",
"modelId": "MM05002916D",
"chinaIdStatus": "",
"oversea": "",
"ktype": null,
"tecId": "TEC000666",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002816D0008",
"modelId": "MM05002816D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 106283,
"tecId": "TEC000639",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002616D0002",
"modelId": "MM05002616D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 34921,
"tecId": "TEC000676",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "One Countryman",
"salesName": "1.6L 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "98",
"maximumOutputKw": "72",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "195/55 R16",
"rearTyreSpecification": "195/55 R16",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002816D0008",
"modelId": "MM05002816D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 106283,
"tecId": "TEC000639",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "standard"
},
{
"shortId": "MM05002716D0002",
"modelId": "MM05002716D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 56172,
"tecId": "TEC000640",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "JCW Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16C",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "218",
"maximumOutputKw": "160",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "standard"
}
],
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 16
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelName": "Countryman",
"total": 16
}
]
},
"yearFacet": [
{
"count": 16,
"year": 2014
}
],
"salesNameFacet": {
"total": 6,
"data": [
{
"salesName": "1.6L 手自一体",
"total": 2
},
{
"salesName": "1.6L 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6L 手自一体 Fun",
"total": 2
},
{
"salesName": "1.6T 手自一体",
"total": 6
},
{
"salesName": "1.6T 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6T 手自一体 Fun",
"total": 2
}
]
}
}