Skip to content
Eden Engine

Consumer Vehicle Reviews (by Make, Model & Year)

omnial/get-vehicle-reviews

Given a vehicle make, model, and model year, returns consumer-submitted Carfax reviews for that exact combination: individual reviews with star rating, title, free-text comments, and a per-category breakdown (Exterior, Interior, Performance, Family, Cost), plus aggregate statistics -- total review count, average rating, and the distribution of reviews by star count. A make/model/year combination with no reviews on file returns zeroed aggregate stats and an empty review list rather than an error.

activeper callv1
Provider
Web & Business Data Network
Category
automotive
Provider price
$0.01365 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "year",
    "model",
    "make"
  ],
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make (e.g. Toyota, Honda, Ford)."
    },
    "year": {
      "type": "string",
      "description": "Vehicle model year as a 4-digit string (e.g. 2023)."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model (e.g. Camry, Civic, F-150). Must correspond to the specified make."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "modelYears": {
          "type": "object",
          "description": "Exactly one key present per call: the queried `year` input, verbatim (e.g. '2023'). Not a fixed set of properties -- the key name varies with the call's own input.",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "reviews": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "number",
                      "description": "The review's own id."
                    },
                    "title": {
                      "type": "string"
                    },
                    "rating": {
                      "type": "number",
                      "description": "1-5 star rating."
                    },
                    "status": {
                      "type": "string",
                      "description": "The review's moderation status, e.g. 'ACCEPTED_MAKE_MODEL_YEAR'."
                    },
                    "helpful": {
                      "type": "object",
                      "properties": {
                        "helpfulCount": {
                          "type": "number"
                        }
                      },
                      "additionalProperties": true
                    },
                    "vehicle": {
                      "type": "object",
                      "properties": {
                        "make": {
                          "type": "string"
                        },
                        "model": {
                          "type": "string"
                        },
                        "modelYear": {
                          "type": "number"
                        }
                      },
                      "additionalProperties": true
                    },
                    "comments": {
                      "type": "string",
                      "description": "The reviewer's free-text comments."
                    },
                    "sections": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "description": "A review category, e.g. 'Cost', 'Exterior', 'Performance', 'Family', 'Interior'."
                          },
                          "rating": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": true
                      },
                      "description": "Per-category star ratings the reviewer gave, when provided."
                    },
                    "changedOn": {
                      "type": "string",
                      "description": "ISO 8601 timestamp the review was last moderated/updated."
                    },
                    "createdOn": {
                      "type": "string",
                      "description": "ISO 8601 timestamp the review was submitted."
                    },
                    "updatedBy": {
                      "type": "string",
                      "description": "The moderator or moderation-system label that last touched this review, e.g. 'Marvin (the Moderator)'. Not a per-reviewer identity: the same label appears on every review in the fixture, identifying the shared moderation process rather than any individual person."
                    },
                    "screenName": {
                      "type": "string",
                      "description": "The reviewer's own publicly displayed name or handle, exactly as it appears on the published review -- observed values range from clear pseudonyms ('CamryGirl') to what read as a reviewer's real name ('Roxanne Davis'), since this is whatever the reviewer chose to submit with their public review."
                    }
                  },
                  "additionalProperties": true
                },
                "description": "Individual reviews for this exact make/model/year. Empty when none are on file."
              },
              "totalReviews": {
                "type": "number",
                "description": "Review count for this exact make/model/year. 0 when none are on file."
              },
              "averageRating": {
                "type": "number",
                "description": "Average star rating for this exact make/model/year. 0 when none are on file."
              },
              "totalsByRating": {
                "type": "object",
                "properties": {
                  "1": {
                    "type": "number"
                  },
                  "2": {
                    "type": "number"
                  },
                  "3": {
                    "type": "number"
                  },
                  "4": {
                    "type": "number"
                  },
                  "5": {
                    "type": "number"
                  }
                },
                "description": "Review counts keyed '1' through '5' (star rating).",
                "additionalProperties": true
              },
              "percentageByRating": {
                "type": "object",
                "properties": {
                  "1": {
                    "type": "number"
                  },
                  "2": {
                    "type": "number"
                  },
                  "3": {
                    "type": "number"
                  },
                  "4": {
                    "type": "number"
                  },
                  "5": {
                    "type": "number"
                  }
                },
                "description": "Percent of reviews at each star rating, keyed '1' through '5'.",
                "additionalProperties": true
              },
              "averageRatingByCategory": {
                "type": "object",
                "description": "Average rating per review category, e.g. 'Cost', 'Exterior', 'Family', 'Interior', 'Performance'. All zero when no reviews exist.",
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "additionalProperties": true
          }
        },
        "overallTotalReviews": {
          "type": "number",
          "description": "Total review count across ALL model years of this make/model, not just the queried year. 0 when no reviews exist for any year."
        },
        "overallAverageRating": {
          "type": "number",
          "description": "Average star rating across ALL model years of this make/model, not just the queried year. 0 when no reviews exist for any year."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed."
    }
  },
  "description": "The vehicle-reviews result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.01365
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 23, 2026