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