Catalog
Build slug-addressable manufacturer and model-group navigation.
Paginated manufacturer catalog with inventory counts.
Requires the catalog scope.
Parameters
countrystring · query stringRestrict to a country or europe.
Example DE·Where the value comes from /api/countries -> country_details[].code
limit / offset / page / page_sizeinteger · query stringStandard pagination. Default limit 50.
Example 20 / 0·Where the value comes from Pagination state in your application.
Example requests
GET https://api.thecarapi.com/api/catalog/manufacturers?country=DE&limit=20GET https://api.thecarapi.com/api/catalog/manufacturers?page=2&page_size=25Example response
{
"success": true,
"results": [
{
"slug": "bmw",
"name": "BMW",
"inventory_count": 1543,
"brand_id": 12
}
],
"total": 96,
"limit": 50,
"offset": 0,
"total_pages": 2,
"max_page": 2
}Resolve one manufacturer by slug.
Requires the catalog scope.
Parameters
slugstring · in the URL pathrequiredManufacturer slug.
Example bmw·Where the value comes from /api/catalog/manufacturers -> results[].slug
countrystring · query stringOptional country restriction.
Example DE·Where the value comes from /api/countries -> country_details[].code
Example requests
GET https://api.thecarapi.com/api/catalog/manufacturers/bmwGET https://api.thecarapi.com/api/catalog/manufacturers/bmw?country=DEExample response
{
"success": true,
"manufacturer": {
"slug": "bmw",
"name": "BMW",
"inventory_count": 1543,
"brand_id": 12
}
}Return aggregate manufacturer statistics.
Requires the catalog scope.
Parameters
countrystring · query stringOptional country restriction.
Example DE·Where the value comes from /api/countries -> country_details[].code
Example requests
GET https://api.thecarapi.com/api/catalog/manufacturers/statsGET https://api.thecarapi.com/api/catalog/manufacturers/stats?country=DEExample response
{
"success": true,
"total_manufacturers": 96,
"active_manufacturers": 84
}Paginated model groups for one manufacturer.
Requires the catalog scope.
Parameters
manufacturer__slugstring · query stringrequiredParent manufacturer slug.
Example bmw·Where the value comes from /api/catalog/manufacturers -> results[].slug
searchstring · query stringSubstring filter on model name.
Example 320·Where the value comes from Free text entered by your user.
countrystring · query stringOptional country restriction.
Example DE·Where the value comes from /api/countries -> country_details[].code
limit / offset / page / page_sizeinteger · query stringStandard pagination. Default limit 50.
Example 20 / 0·Where the value comes from Pagination state in your application.
Example requests
GET https://api.thecarapi.com/api/catalog/model-groups?manufacturer__slug=bmw&search=320GET https://api.thecarapi.com/api/catalog/model-groups?manufacturer__slug=bmw&country=DE&page=2&page_size=20Example response
{
"success": true,
"results": [
{
"slug": "320d",
"name": "320d",
"inventory_count": 210,
"manufacturer_slug": "bmw"
}
],
"total": 34,
"limit": 50,
"offset": 0,
"total_pages": 1,
"max_page": 1
}Resolve one model group by slug.
Requires the catalog scope.
Parameters
slugstring · in the URL pathrequiredModel-group slug.
Example 320d·Where the value comes from /api/catalog/model-groups -> results[].slug
manufacturer__slugstring · query stringManufacturer slug for disambiguation.
Example bmw·Where the value comes from /api/catalog/manufacturers -> results[].slug
countrystring · query stringOptional country restriction.
Example DE·Where the value comes from /api/countries -> country_details[].code
Example requests
GET https://api.thecarapi.com/api/catalog/model-groups/320d?manufacturer__slug=bmwGET https://api.thecarapi.com/api/catalog/model-groups/320d?manufacturer__slug=bmw&country=DEExample response
{
"success": true,
"model_group": {
"slug": "320d",
"name": "320d",
"inventory_count": 210,
"manufacturer_slug": "bmw"
}
}