Reference

Endpointhttps://sharp-stream-8e0aadb6f.api.apitogo.com

Filter values, statistics, health check

Health check

GET

https://sharp-stream-8e0aadb6f.api.apitogo.com

/health

Returns ok when the API is running. Use it for uptime monitoring.

Health check › Responses

200

status

string

Available filter values with counts

GET

https://sharp-stream-8e0aadb6f.api.apitogo.com

/api/filters

Returns the values accepted by the search filters, with the number of trims for each. Use it to fill dropdowns.

Available filter values with counts › Responses

200

object[]

object

sort_fields

string[]

GET/api/filters

curl --request GET \
  --url https://sharp-stream-8e0aadb6f.api.apitogo.com/api/filters \
  --header 'X-API-Key: YOUR_API_KEY'

shell

Example Responses

{
  "years": [
    {
      "v": 2022,
      "count": 2938
    },
    {
      "v": 2023,
      "count": 2902
    },
    {
      "v": 2024,
      "count": 2320
    }
  ],
  "body_types": [
    {
      "v": "Convertible",
      "count": 232
    },
    {
      "v": "Coupe",
      "count": 377
    },
    {
      "v": "Ext Van",
      "count": 106
    }
  ],
  "engine_types": [
    {
      "v": "diesel",
      "count": 215
    },
    {
      "v": "electric",
      "count": 478
    },
    {
      "v": "electric (fuel cell)",
      "count": 8
    }
  ],
  "fuel_types": [
    {
      "v": "diesel fuel",
      "count": 215
    },
    {
      "v": "electric",
      "count": 480
    },
    {
      "v": "flex-fuel (unleaded/E85)",
      "count": 171
    }
  ],
  "drive_types": [
    {
      "v": "all wheel drive",
      "count": 3063
    },
    {
      "v": "four wheel drive",
      "count": 1689
    },
    {
      "v": "front wheel drive",
      "count": 1456
    }
  ],
  "countries_of_origin": [
    {
      "v": "Germany",
      "count": 1510
    },
    {
      "v": "Italy",
      "count": 90
    },
    {
      "v": "Japan",
      "count": 2085
    }
  ],
  "car_classifications": [
    {
      "v": "Compact SUV",
      "count": 320
    },
    {
      "v": "Compact car",
      "count": 745
    },
    {
      "v": "Compact crossover SUV",
      "count": 803
    }
  ],
  "price_range": {
    "min": 13600,
    "max": 555000
  },
  "horsepower_range": {
    "min": 76,
    "max": 1111
  },
  "sort_fields": [
    "price",
    "year",
    "make"
  ]
}

json

application/json

Dataset statistics

GET

https://sharp-stream-8e0aadb6f.api.apitogo.com

/api/stats

Returns totals, per-year and per-body-type summaries, the 5 most powerful and the 5 cheapest trims.

Dataset statistics › Responses

200

object

object[]

GET/api/stats

curl --request GET \
  --url https://sharp-stream-8e0aadb6f.api.apitogo.com/api/stats \
  --header 'X-API-Key: YOUR_API_KEY'

shell

Example Responses

{
  "totals": {
    "makes": 46,
    "models": 443,
    "trims": 8168,
    "colors": 109022
  },
  "by_year": [
    {
      "year": 2022,
      "trims": 2938,
      "models": 393,
      "avg_msrp": 55405,
      "avg_hp": 314,
      "electric_trims": 115
    },
    {
      "year": 2023,
      "trims": 2902,
      "models": 384,
      "avg_msrp": 59408,
      "avg_hp": 319,
      "electric_trims": 186
    }
  ],
  "by_body_type": [
    {
      "body_type": "SUV",
      "trims": 3502,
      "avg_msrp": 55142
    },
    {
      "body_type": "Sedan",
      "trims": 1168,
      "avg_msrp": 60469
    }
  ],
  "top_horsepower": [
    {
      "id": 401931137,
      "make": "Lucid",
      "model": "Air",
      "year": 2022,
      "trim": "Dream Edition Performance",
      "trim_description": "Dream Edition Performance 4dr Sedan AWD (electric DD)",
      "body_type": "Sedan",
      "base_msrp": 169000,
      "horsepower_hp": 1111,
      "engine_type": "electric",
      "fuel_type": "electric",
      "drive_type": "all wheel drive",
      "transmission": "1-speed direct drive",
      "total_seating": 5,
      "epa_combined_mpg": null,
      "epa_combined_mpge": 111,
      "epa_electricity_range_mi": 451,
      "image_urls": [
        "https://media.ed.edmunds-media.com/lucid/air/2022/oem/2022_lucid_air_sedan_dream-editio...",
        "https://media.ed.edmunds-media.com/lucid/air/2022/oem/2022_lucid_air_sedan_dream-editio..."
      ]
    },
    {
      "id": 401991128,
      "make": "Lucid",
      "model": "Air",
      "year": 2023,
      "trim": "Grand Touring Performance",
      "trim_description": "Grand Touring Performance 4dr Sedan AWD (electric DD)",
      "body_type": "Sedan",
      "base_msrp": 179000,
      "horsepower_hp": 1050,
      "engine_type": "electric",
      "fuel_type": "electric",
      "drive_type": "all wheel drive",
      "transmission": "1-speed direct drive",
      "total_seating": 5,
      "epa_combined_mpg": null,
      "epa_combined_mpge": 111,
      "epa_electricity_range_mi": 446,
      "image_urls": [
        "https://media.ed.edmunds-media.com/lucid/air/2023/oem/2023_lucid_air_sedan_grand-tourin...",
        "https://media.ed.edmunds-media.com/lucid/air/2023/oem/2023_lucid_air_sedan_grand-tourin..."
      ]
    }
  ],
  "most_affordable": [
    {
      "id": 401894900,
      "make": "Chevrolet",
      "model": "Spark",
      "year": 2022,
      "trim": "LS",
      "trim_description": "LS 4dr Hatchback (1.4L 4cyl 5M)",
      "body_type": "Hatchback",
      "base_msrp": 13600,
      "horsepower_hp": 98,
      "engine_type": "gas",
      "fuel_type": "regular unleaded",
      "drive_type": "front wheel drive",
      "transmission": "5-speed manual",
      "total_seating": 4,
      "epa_combined_mpg": 33,
      "epa_combined_mpge": null,
      "epa_electricity_range_mi": null,
      "image_urls": [
        "https://media.ed.edmunds-media.com/chevrolet/spark/2021/oem/2021_chevrolet_spark_4dr-ha...",
        "https://media.ed.edmunds-media.com/chevrolet/spark/2022/evox/2022_chevrolet_spark_4dr-h..."
      ]
    },
    {
      "id": 401925892,
      "make": "Mitsubishi",
      "model": "Mirage",
      "year": 2022,
      "trim": "ES",
      "trim_description": "ES 4dr Hatchback (1.2L 3cyl 5M)",
      "body_type": "Hatchback",
      "base_msrp": 14645,
      "horsepower_hp": 76,
      "engine_type": "gas",
      "fuel_type": "regular unleaded",
      "drive_type": "front wheel drive",
      "transmission": "5-speed manual",
      "total_seating": 5,
      "epa_combined_mpg": 36,
      "epa_combined_mpge": null,
      "epa_electricity_range_mi": null,
      "image_urls": [
        "https://media.ed.edmunds-media.com/mitsubishi/mirage/2022/oem/2022_mitsubishi_mirage_4d...",
        "https://media.ed.edmunds-media.com/mitsubishi/mirage/2022/evox/2022_mitsubishi_mirage_4..."
      ]
    }
  ]
}

json

application/json

Trims

Available filter values with counts

GET

https://sharp-stream-8e0aadb6f.api.apitogo.com

/api/filters

Returns the values accepted by the search filters, with the number of trims for each. Use it to fill dropdowns.

Available filter values with counts › Responses

200

object[]

object

sort_fields

string[]

Dataset statistics

GET

https://sharp-stream-8e0aadb6f.api.apitogo.com

/api/stats

Returns totals, per-year and per-body-type summaries, the 5 most powerful and the 5 cheapest trims.

Dataset statistics › Responses

200

object

object[]