MotorTrend ranking
One MotorTrend ranking, 10 vehicles per page in rank order: model id, make, model, year, MotorTrend Score, 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 MotorTrend API: 10 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
path | string | Ranking path from /rankings (e.g. /rankings/suvs/compact). Example: /rankings/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/motortrend/v1/ranking?path=%2Frankings%2Fsuvs%2Fcompact" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/motortrend/v1/ranking",
params={"path": "/rankings/suvs/compact"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/motortrend/v1/ranking");
url.searchParams.set("path", "/rankings/suvs/compact");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); 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/suvs/compact","year": null,"type": "ranked-list","used": false,"summary": "From acceleration to comfort, MotorTrend’s experts test and rate hundreds of vehicles each year. See our top picks, detailed comparisons, an…","overview": "At MotorTrend, our experts rigorously evaluate the best compact SUVs to help you find the right vehicle with confidence. Backed by more than…","faq": [],"subrankings": [],"past_years": [],"page": 1,"total": 14,"count": 10,"next_page": 2,"items": [{"rank": 1,"model_id": "kia_sportage","make": "Kia","model": "Sportage","year": 2026,"title": "2026 Kia Sportage","motortrend_score": 9.5,"price": {"low": 30285,"high": 41185,"is_estimate": false,"currency": "USD"},"fuel_type": "gas","mpg_combined": null,"mpge_combined": null,"battery_range_mi": null,"highs": null,"lows": null,"verdict": null,"summary": "The 2026 Kia Sportage offers plenty of space, generous standard equipment, and inoffensive styling, but its dull driving character contradic…","other_rankings": [],"url": "https://www.motortrend.com/cars/kia/sportage/2026"},{"rank": 2,"model_id": "nissan_rogue","make": "Nissan","model": "Rogue","year": 2026,"title": "2026 Nissan Rogue","motortrend_score": 9.4,"price": {"low": 31065,"high": 40965,"is_estimate": false,"currency": "USD"},"fuel_type": "gas","mpg_combined": null,"mpge_combined": null,"battery_range_mi": null,"highs": null,"lows": null,"verdict": null,"summary": "The 2026 Nissan Rogue compact SUV is far from roguish, but being handsome, calm, and comfortable isn't a bad thing.","other_rankings": [],"url": "https://www.motortrend.com/cars/nissan/rogue/2026"},"… 8 more"],"url": "https://www.motortrend.com/rankings/suvs/compact","cached": false,"credits_used": 1}