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
        }
    ]
}