Car Review
vidextract.predefined.car_review.v1
A car review extracted from a video — the vehicle reviewed, its specs, the reviewer's assessment of how it drives, and the verdict. Optional fields are omitted when the creator does not state them — do not infer figures that were never said.
Fields
Identity of the car being reviewed.
Two or three sentences summarizing the reviewer's overall take.
Engine/motor and drivetrain details.
Performance and efficiency figures the reviewer cites.
Price or starting price as stated, including currency, e.g. '$33,000'. Omit if not stated.
Strengths the reviewer highlights, each a short phrase.
Weaknesses or criticisms the reviewer raises, each a short phrase.
Specific observations about how the car drives, handles, rides, sounds, or feels.
Observations about cabin quality, space, comfort, tech, and infotainment.
Any numeric or star ratings the reviewer assigns to specific aspects.
Rival cars the reviewer compares this one against, by name.
Who the reviewer says the car is best suited to. Omit if not stated.
The reviewer's closing recommendation or bottom-line judgement. Omit if none given.
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "vidextract.predefined.car_review.v1",
"title": "Car Review",
"description": "A car review extracted from a video — the vehicle reviewed, its specs, the reviewer's assessment of how it drives, and the verdict. Optional fields are omitted when the creator does not state them — do not infer figures that were never said.",
"type": "object",
"required": [
"vehicle",
"summary"
],
"additionalProperties": false,
"properties": {
"vehicle": {
"type": "object",
"description": "Identity of the car being reviewed.",
"required": [
"model"
],
"additionalProperties": false,
"properties": {
"make": {
"type": "string",
"description": "Manufacturer, e.g. 'Toyota', 'Porsche'. Omit if not stated."
},
"model": {
"type": "string",
"description": "Model name, e.g. 'GR86', '911 Turbo S'."
},
"trim": {
"type": "string",
"description": "Trim or variant, e.g. 'Performance', 'Long Range'. Omit if not stated."
},
"modelYear": {
"type": "integer",
"description": "Model year, e.g. 2024. Omit if not stated."
},
"bodyType": {
"type": "string",
"enum": [
"hatchback",
"sedan",
"coupe",
"convertible",
"suv",
"crossover",
"wagon",
"pickup",
"van",
"sports-car",
"mpv"
],
"description": "Body style. Pick the single best fit. Omit if unclear."
}
}
},
"summary": {
"type": "string",
"description": "Two or three sentences summarizing the reviewer's overall take."
},
"powertrain": {
"type": "object",
"description": "Engine/motor and drivetrain details.",
"additionalProperties": false,
"properties": {
"fuelType": {
"type": "string",
"enum": [
"petrol",
"diesel",
"hybrid",
"plug-in-hybrid",
"electric",
"hydrogen"
],
"description": "Energy source. Omit if unclear."
},
"engine": {
"type": "string",
"description": "Engine/motor description, e.g. '2.4L flat-four', 'dual-motor'. Omit if not stated."
},
"horsepower": {
"type": "integer",
"description": "Peak power in horsepower if stated. Omit otherwise."
},
"torque": {
"type": "string",
"description": "Peak torque as stated, including units, e.g. '184 lb-ft'. Omit otherwise."
},
"transmission": {
"type": "string",
"description": "Transmission, e.g. '6-speed manual', '8-speed auto'. Omit if not stated."
},
"drivetrain": {
"type": "string",
"enum": [
"fwd",
"rwd",
"awd",
"4wd"
],
"description": "Driven wheels. Omit if not stated."
}
}
},
"performance": {
"type": "object",
"description": "Performance and efficiency figures the reviewer cites.",
"additionalProperties": false,
"properties": {
"zeroToSixty": {
"type": "string",
"description": "0-60 mph or 0-100 km/h time as stated, e.g. '6.1 seconds'. Omit if not stated."
},
"topSpeed": {
"type": "string",
"description": "Top speed as stated with units, e.g. '155 mph'. Omit entirely if not stated — never write placeholders like 'not stated' or 'N/A'."
},
"rangeMiles": {
"type": "integer",
"description": "Electric/hybrid range in miles if stated. Omit otherwise."
},
"fuelEconomy": {
"type": "string",
"description": "Fuel economy or efficiency as stated, e.g. '32 mpg', '4.2 mi/kWh'. Omit otherwise."
}
}
},
"price": {
"type": "string",
"description": "Price or starting price as stated, including currency, e.g. '$33,000'. Omit if not stated."
},
"pros": {
"type": "array",
"description": "Strengths the reviewer highlights, each a short phrase.",
"items": {
"type": "string"
}
},
"cons": {
"type": "array",
"description": "Weaknesses or criticisms the reviewer raises, each a short phrase.",
"items": {
"type": "string"
}
},
"drivingImpressions": {
"type": "array",
"description": "Specific observations about how the car drives, handles, rides, sounds, or feels.",
"items": {
"type": "string"
}
},
"interiorNotes": {
"type": "array",
"description": "Observations about cabin quality, space, comfort, tech, and infotainment.",
"items": {
"type": "string"
}
},
"ratings": {
"type": "array",
"description": "Any numeric or star ratings the reviewer assigns to specific aspects.",
"items": {
"type": "object",
"required": [
"aspect",
"score"
],
"additionalProperties": false,
"properties": {
"aspect": {
"type": "string",
"description": "What is rated, e.g. 'handling', 'value', 'overall'."
},
"score": {
"type": "string",
"description": "The score as stated, e.g. '4.5/5', '8/10'."
}
}
}
},
"competitors": {
"type": "array",
"description": "Rival cars the reviewer compares this one against, by name.",
"items": {
"type": "string"
}
},
"recommendedFor": {
"type": "string",
"description": "Who the reviewer says the car is best suited to. Omit if not stated."
},
"verdict": {
"type": "string",
"description": "The reviewer's closing recommendation or bottom-line judgement. Omit if none given."
}
}
}Use it via the API
Pass schemaId: "vidextract.predefined.car_review.v1" when you submit an extraction. The call returns an id immediately. Poll GET /v1/extractions/{id}/result (or register a webhook) for the structured result.
curl -s -X POST https://postreef.com/v1/extractions \
-H "x-api-key: $VIDEXTRACT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"inputs": ["transcript", "comments"],
"schemaId": "vidextract.predefined.car_review.v1"}'Full request/response shape in the API reference; copy-paste poll loops in the API quickstart.
Pass schemaId: "vidextract.predefined.car_review.v1" in your request to extract with this schema.