Manufacturer > Model > Vehicle facet search
This request allows you to call and limit vehicle results by manufacturer, model, year and/or kType/carId. Vehicle results are available after a specific manufacturer, model and year is requested or manufacturer, model and carId is requested. The full list of all manufacturers and their models are in the response body.
Query URL
https://onedb.tecalliance.cn/api/vehicles
Step 1: Fetch a list of all manufacturer with the total number of vehicles.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| country | String | Yes | CN | This is the country code according to ISO 3166. |
| lang | String | Yes | EN | This is the language code according to ISO 639. |
| includeManufacturerFacet | boolean | Yes | true | This request will build the manufacturer facet. |
JSON Input
{
"country":"CN",
"lang":"EN",
"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": 260,
"data": [
{
"manuId": 3854,
"manuName": "ABARTH",
"count": 1
},
{
"manuId": 1505,
"manuName": "ACURA",
"count": 19
},
{
"manuId": 4593,
"manuName": "ACURA (GAC)",
"count": 6
},
{
"manuId": 2,
"manuName": "ALFA ROMEO",
"count": 8
},
{
"manuId": 2847,
"manuName": "ANCHI",
"count": 7
},
{
"manuId": 881,
"manuName": "ASTON MARTIN",
"count": 26
},
{
"manuId": 5,
"manuName": "AUDI",
"count": 227
},
........
........
........
........
]
},
"modelFacet": {
"total": 0,
"data": null
},
"yearFacet": 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 |
|---|---|---|---|---|
| country | String | Yes | CN | This is the country code according to ISO 3166. |
| lang | String | Yes | EN | This is the language code according to ISO 639. |
| manuId | Integer | Yes | 5 | This is the manufacturer ID. |
| includeManufacturerFacet | boolean | No | true | This parameter will build the manufacturer facet. |
| includeModelFacet | boolean | Yes | true | This parameter will build the model facet. |
JSON Input
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"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": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 227
}
]
},
"modelFacet": {
"total": 50,
"data": [
{
"modelId": 8604,
"modelName": "A1 (8X1, 8XK)",
"count": 2
},
{
"modelId": 9730,
"modelName": "A1 Sportback (8XA, 8XF)",
"count": 2
},
{
"modelId": 4955,
"modelName": "A3 (8P1)",
"count": 6
},
{
"modelId": 6724,
"modelName": "A3 Convertible (8P7)",
"count": 2
},
{
"modelId": 11611,
"modelName": "A3 Convertible (8V7, 8VE)",
"count": 2
},
{
"modelId": 11282,
"modelName": "A3 Limousine (8VS, 8VM)",
"count": 5
},
{
"modelId": 5143,
"modelName": "A3 Sportback (8PA)",
"count": 8
},
{
"modelId": 10459,
"modelName": "A3 Sportback (8VA, 8VF)",
"count": 3
},
{
"modelId": 4731,
"modelName": "A4 (8E2, B6)",
"count": 2
},
{
"modelId": 5376,
"modelName": "A4 (8EC, B7)",
"count": 5
},
{
"modelId": 6418,
"modelName": "A4 (8K2, B8)",
"count": 11
},
{
"modelId": 14695,
"modelName": "A4 (8W2, B9)",
"count": 1
},
{
"modelId": 8031,
"modelName": "A4 Allroad (8KH, B8)",
"count": 2
},
{
"modelId": 36378,
"modelName": "A4 Allroad (8WH, B9)",
"count": 1
},
{
"modelId": 5377,
"modelName": "A4 Avant (8ED, B7)",
"count": 3
},
{
"modelId": 6988,
"modelName": "A4 Avant (8K5, B8)",
"count": 6
},
{
"modelId": 4840,
"modelName": "A4 Convertible (8H7, B6, 8HE, B7)",
"count": 4
},
{
"modelId": 6243,
"modelName": "A5 (8T3)",
"count": 15
},
{
"modelId": 36928,
"modelName": "A5 (F53)",
"count": 3
},
{
"modelId": 8030,
"modelName": "A5 Convertible (8F7)",
"count": 12
},
{
"modelId": 37293,
"modelName": "A5 Convertible (F57)",
"count": 3
},
{
"modelId": 8159,
"modelName": "A5 Sportback (8TA)",
"count": 11
},
{
"modelId": 37116,
"modelName": "A5 Sportback (F5A)",
"count": 4
},
{
"modelId": 1891,
"modelName": "A6 (4B2, C5)",
"count": 3
},
{
"modelId": 5110,
"modelName": "A6 (4F2, C6)",
"count": 7
},
{
"modelId": 9154,
"modelName": "A6 (4G2, 4GC, C7)",
"count": 3
},
{
"modelId": 5546,
"modelName": "A6 Allroad (4FH, C6)",
"count": 1
},
{
"modelId": 10161,
"modelName": "A6 Allroad (4GH, 4GJ)",
"count": 1
},
{
"modelId": 5381,
"modelName": "A6 Avant (4F5, C6)",
"count": 1
},
{
"modelId": 9627,
"modelName": "A6 Avant (4G5, 4GD, C7)",
"count": 3
},
{
"modelId": 8986,
"modelName": "A7 Sportback (4GA, 4GF)",
"count": 12
},
{
"modelId": 265,
"modelName": "A8 (4D2, 4D8)",
"count": 1
},
{
"modelId": 4935,
"modelName": "A8 (4E2, 4E8)",
"count": 11
},
{
"modelId": 8627,
"modelName": "A8 (4H2, 4H8, 4HC, 4HL)",
"count": 11
},
{
"modelId": 38219,
"modelName": "A8 (4N2, 4N8)",
"count": 1
},
{
"modelId": 4632,
"modelName": "ALLROAD (4BH, C5)",
"count": 1
},
{
"modelId": 9731,
"modelName": "Q3 (8UB, 8UG)",
"count": 2
},
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
},
{
"modelId": 5461,
"modelName": "Q7 (4LB)",
"count": 12
},
{
"modelId": 14159,
"modelName": "Q7 (4MB)",
"count": 3
},
{
"modelId": 6244,
"modelName": "R8 (422, 423)",
"count": 3
},
{
"modelId": 14514,
"modelName": "R8 (4S3, 4SP)",
"count": 2
},
{
"modelId": 8262,
"modelName": "R8 Spyder (427, 429)",
"count": 2
},
{
"modelId": 36765,
"modelName": "R8 Spyder (4S9, 4SR)",
"count": 1
},
{
"modelId": 5544,
"modelName": "TT (8J3)",
"count": 8
},
{
"modelId": 3851,
"modelName": "TT (8N3)",
"count": 2
},
{
"modelId": 12912,
"modelName": "TT (FV3, FVP)",
"count": 4
},
{
"modelId": 5608,
"modelName": "TT Roadster (8J9)",
"count": 7
},
{
"modelId": 4089,
"modelName": "TT Roadster (8N9)",
"count": 2
},
{
"modelId": 13274,
"modelName": "TT Roadster (FV9, FVR)",
"count": 3
}
]
},
"yearFacet": null
}
Step 3: Limit results to search for all available model years from a specific vehicle model.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| country | String | Yes | CN | This is the country code according to ISO 3166. |
| lang | String | Yes | EN | This is the language code according to ISO 639. |
| manuId | Integer | Yes | 5 | This is the manufacturer ID. |
| modelId | Integer | Yes | 7534 | This is the model ID from a vehicle manufacturer. |
| includeManufacturerFacet | boolean | No | true | This parameter will build the manufacturer facet. |
| includeModelFacet | boolean | Yes | true | This parameter will build the model facet. |
| includeYearfacet | boolean | Yes | true | This parameter will build the all available years for that selected model. |
JSON Input
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"modelId": 7534,
"includeManufacturerFacet": true,
"includeModelFacet":true,
"includeYearfacet":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": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 7
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
}
]
},
"yearFacet": [
{
"count": 6,
"year": 2020
},
{
"count": 6,
"year": 2019
},
{
"count": 6,
"year": 2018
},
{
"count": 6,
"year": 2017
},
{
"count": 7,
"year": 2016
},
{
"count": 7,
"year": 2015
},
{
"count": 6,
"year": 2014
},
{
"count": 6,
"year": 2013
},
{
"count": 4,
"year": 2012
},
{
"count": 3,
"year": 2011
},
{
"count": 3,
"year": 2010
},
{
"count": 3,
"year": 2009
},
{
"count": 2,
"year": 2008
}
]
}
Step 4: Get all available vehicles for a manufacturer > model > year combination. It is possible to split number of vehicles into multiple requests.
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| country | String | Yes | CN | This is the country code according to ISO 3166. |
| lang | String | Yes | EN | This is the language code according to ISO 639. |
| manuId | Integer | Yes | 5 | This is the manufacturer ID. |
| modelId | Integer | Yes | 7534 | This is the model ID from a vehicle manufacturer. |
| year | Integer | Yes | 2015 | This is the year of the vehicle model. |
| includeManufacturerFacet | boolean | No | true | This parameter will build the manufacturer facet. |
| includeModelFacet | boolean | Yes | true | This parameter will build the model facet. |
| includeYearfacet | boolean | Yes | true | This parameter will build the all available years for that selected model. |
JSON Input
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"modelId": 7534,
"year":2015,
"includeManufacturerFacet": true,
"includeModelFacet":true,
"includeYearfacet":true
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
{
"totalMatching": 7,
"maxAllowedPage": 1,
"vehicles": [
{
"carId": 27563,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 211,
"powerKwTo": 155,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200811",
"yearOfConstrTo": "",
"engineCode": [
"CDNC",
"CAEB",
"CPMA"
]
},
{
"carId": 30740,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 3197,
"cylinderCapacityLiter": 320,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 270,
"powerKwTo": 199,
"typeName": "3.2 FSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "FSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200811",
"yearOfConstrTo": "",
"engineCode": [
"CALB"
]
},
{
"carId": 31955,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 180,
"powerKwTo": 132,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200908",
"yearOfConstrTo": "",
"engineCode": [
"CDNB",
"CNCB"
]
},
{
"carId": 56113,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 2995,
"cylinderCapacityLiter": 300,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 272,
"powerKwTo": 200,
"typeName": "3.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201301",
"yearOfConstrTo": "",
"engineCode": [
"CTUC",
"CTVA"
]
},
{
"carId": 56939,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol/Electro",
"engineType": "Hybrid",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 245,
"powerKwTo": 180,
"typeName": "2.0 40 Hybrid quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "40 Hybrid ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201209",
"yearOfConstrTo": "201605",
"engineCode": null
},
{
"carId": 100066,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 2995,
"cylinderCapacityLiter": 300,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 354,
"powerKwTo": 260,
"typeName": "SQ5 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "SQ5 TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201305",
"yearOfConstrTo": "",
"engineCode": [
"CTUD",
"CTXA"
]
},
{
"carId": 116058,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 230,
"powerKwTo": 169,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201508",
"yearOfConstrTo": "",
"engineCode": [
"CNCE"
]
}
],
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 7
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
}
]
},
"yearFacet": [
{
"count": 6,
"year": 2020
},
{
"count": 6,
"year": 2019
},
{
"count": 6,
"year": 2018
},
{
"count": 6,
"year": 2017
},
{
"count": 7,
"year": 2016
},
{
"count": 7,
"year": 2015
},
{
"count": 6,
"year": 2014
},
{
"count": 6,
"year": 2013
},
{
"count": 4,
"year": 2012
},
{
"count": 3,
"year": 2011
},
{
"count": 3,
"year": 2010
},
{
"count": 3,
"year": 2009
},
{
"count": 2,
"year": 2008
}
]
}