Car and Driver ranking

GET https://api.api.sh/caranddriver/v1/ranking
1 credit / call automotive try it in the playground →

One Car and Driver ranking, 10 vehicles per page in rank order: model id, make, model, year, rating and award flags, price range, fuel type, combined mpg/MPGe and range, highs, lows, verdict, summary, the vehicle's other rankings and its page link; plus the ranking's summary, FAQ, sub-rankings (for category pages) and past years. Pass next_page back as page; null on the last page.

Every response includes credits_used: the credits this call cost.

Part of the Car and Driver API: 12 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
path string Ranking path from /rankings (e.g. /rankings/best-suvs/compact). Example: /rankings/best-suvs/compact
url string A rankings page link (instead of path).
page integer Page (10 vehicles per page). Example: 1

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/caranddriver/v1/ranking?path=%2Frankings%2Fbest-suvs%2Fcompact" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"title": "Best Compact SUVs","path": "/rankings/best-suvs/compact","year": null,"type": "ranked-list","used": false,"summary": "Wondering what compact SUV to buy? Our testing team looks at over 200 data points when rating vehicles. Check out what made our list of the …","overview": "Car and Driver's rankings are arrived at from the results of our extensive instrumented testing of several hundred vehicles each year and fr…","faq": [{"question": "What is a compact SUV?","answer": "The compact-SUV category is the second-smallest class of sport-utility vehicles. Compact SUVs are larger than subcompact SUVs but smaller th…"},{"question": "What are the pros and cons of compact SUVs?","answer": "While small and fuel-efficient, compact SUVs typically have enough seating and cargo space to accommodate a small family. They are also rela…"},"… 1 more"],"subrankings": [],"past_years": [{"year": 2024,"path": "/rankings/best-suvs/compact/2024","url": "https://www.caranddriver.com/rankings/best-suvs/compact/2024"},{"year": 2023,"path": "/rankings/best-suvs/compact/2023","url": "https://www.caranddriver.com/rankings/best-suvs/compact/2023"},"… 3 more"],"page": 1,"total": 17,"count": 10,"next_page": 2,"items": [{"rank": 1,"model_id": "honda_cr-v","make": "Honda","model": "CR-V","year": 2027,"title": "2027 Honda CR-V","rating": {"rating": 10,"max_rating": 10,"editors_choice": false,"ten_best": false,"ev_of_the_year": false,"safety_rating": {"low": null,"high": null}},"price": {"low": 33070,"high": 38850,"is_estimate": false,"currency": "USD","market": {"low": 30305,"high": 76382}},"fuel_type": "gas","mpg_combined": {"low": 29,"high": 30},"mpge_combined": null,"battery_range_mi": null,"highs": "Family-friendly room, responsive handling, comfortable ride.","lows": "Not as fuel efficient as some competitors, languid acceleration, the CR-V hybrid does everything better.","verdict": "The Honda CR-V goes above and beyond in the compact crossover segment, earning its reputation as a benchmark for quiet, comfortable, accompl…","summary": "No wonder they sell so many: the Honda CR-V holds on to its top spot in the compact crossover segment, a well-equipped all-arounder with few…","other_rankings": [{"title": "Best AWD SUVs","rank": 1,"path": "/rankings/best-suvs/awd"},{"title": "Honda SUVs","rank": 1,"path": "/rankings/best-suvs/honda"},"… 2 more"],"url": "https://www.caranddriver.com/honda/cr-v-2027"},{"rank": 2,"model_id": "mazda_cx-50","make": "Mazda","model": "CX-50","year": 2026,"title": "2026 Mazda CX-50","rating": {"rating": 9.5,"max_rating": 10,"editors_choice": true,"ten_best": false,"ev_of_the_year": false,"safety_rating": {"low": 5,"high": 5}},"price": {"low": 31395,"high": 44395,"is_estimate": false,"currency": "USD","market": {"low": 27773,"high": 50946}},"fuel_type": "gas","mpg_combined": {"low": 25,"high": 25},"mpge_combined": null,"battery_range_mi": null,"highs": "Playful handling, luxury-adjacent interior, available with a lively turbo four.","lows": "A little snug, luxury-adjacent pricing, merely average warranty terms.","verdict": "A premium model in a mainstream class, the CX-50 is a compact crossover for those in the know.","summary": "The 2026 Mazda CX-50 compact SUV has rugged good looks but refined manners.","other_rankings": [{"title": "Mazda SUVs and Crossovers","rank": 2,"path": "/rankings/best-suvs/mazda"}],"url": "https://www.caranddriver.com/mazda/cx-50-2026"},"… 8 more"],"url": "https://www.caranddriver.com/rankings/best-suvs/compact","cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.