The following table defines the attributes that you can include in a feed.
vin
Required
String
Vehicle Identification Number, a unique alphanumeric identifier for each vehicle.
Shown on Google.
id
Optional
String
An internal stock number that's unique for each vehicle.
Not shown on Google, but may be used to improve data quality.
store_code
Required
String
An internal identifier that's unique for each dealership. Store codes can be any kind of identifier, such as internal account numbers.
Not shown on Google, but may be used to improve data quality.
place_id
Optional
String
The Place ID of the dealership's Business Profile.
Not shown on Google, but may be used to improve data quality.
maps_url
Optional
URL
Google Maps URL of the dealership's Business Profile
Not shown on Google, but may be used to improve data quality.
For more details, see Match with Google Maps URLs .
dealership_name
Required
String
Full dealership name (business name), such as Ford of Mountain
View
Shown on Google.
dealership_address
Required
String
Full dealership address, which includes the city, postal code, and
country. For example, 1800 Amphibious Blvd., Mountain View, CA
94045, US
Shown on Google.
tracking_phone_number
Optional
Telephone number
Phone number used for the vehicle listings experience.
If not specified, Google uses the phone number from the dealer's Business Profile.
Shown on Google.
image_link
Recommended
URL
The main image for the vehicle.
Shown on Google.
additional_image_link
Recommended
URL, repeated
Additional images for the vehicle
Shown on Google.
link
Recommended
URL, UTM/tracking parameters are permitted
Link to the dealer's Vehicle Details Page (VDP).
Google doesn't add or remove any UTM parameters from the URL provided in the feed, or otherwise modify it. However, UTM parameters are permitted and can be included in the VDP by the provider or dealership.
Shown on Google.
date_in_stock
Optional
Date
The date when the vehicle was first available for sale.
Give the date in ISO 8601
format. For example, 2020-01-31
.
Not shown on Google, but may be used to improve data quality.
price
Required
Price
The final sale price for the vehicle.
Give the price in ISO 4217
format. For example, 10499 USD
or 10,499.00 USD
.
Shown on Google.
vehicle_msrp
Recommended for new vehicles
Price
MSRP for a vehicle in its current configuration. This attribute only
applies to vehicles with a condition
of new
.
Give the price in ISO 4217
format. For example, 10499 USD
or 10,499.00 USD
.
Shown on Google.
condition
Required
String
The condition of the vehicle, either new or used. We accept the following values:
- New:
n,new - Used:
u,used
Shown on Google.
certified_pre_owned
Optional
Boolean
Indicates whether the vehicle is OEM certified pre-owned.
We accept the following values:
-
1,y,yes -
0,n,no
Shown on Google.
make
Required
String
Make of the vehicle, such as Toyota
.
Shown on Google.
model
Required
String
Model of the vehicle, such as Civic
. Don't include trim
specifics like LX or EX.
Shown on Google.
trim
Requiredwhere available
String
Trim of the model, such as S
, SV
, or SL
.
Shown on Google.
year
Required
Int
Model year in the format YYYY
.
Shown on Google.
mileage
Requiredfor used vehicles
Int + Unit
Number of miles on the vehicle. For example, 2333
or 52,777 miles
.
Shown on Google.
exterior_color
Recommended
String
OEM-specified exterior color, such as White
, Platinum
, or Metallic Tri-Coat
.
Shown on Google.
exterior_color_generic
Optional
String
Generic exterior color, such as black
or red
.
Shown on Google.
interior_color
Optional
String
OEM-specified interior color, such as Brown
or Ivory
.
Shown on Google.
interior_color_generic
Optional
String
Generic interior color, such as black
or red
.
Shown on Google.
body_style
Optional
String
The body style of the vehicle, such as Sedan, SUV, or Crossover.
The following are some example values:
-
convertible -
coupe -
crossover -
full size van -
hatchback -
minivan -
sedan -
station wagon -
suv -
truck
Shown on Google.
vehicle_option
Recommended
String, repeated
Separated list of the vehicle's standard equipment, along with its
installed options and packages. For example, Leatherette
Seats,Rear View Camera,Navigation System,Front Seat
Heaters,A/C,Sunroof,Bluetooth
Shown on Google.
drive_train
Optional
String
Drivetrain specification of the vehicle
For example, FWD
, RWD
, AWD
, or 4WD
.
Shown on Google.
engine
Optional
String
Engine specification of the vehicle
For example, 5.0L V8 510 hp@6000rpm
Shown on Google.
fuel
Optional
String
Fuel type of the vehicle
For example, Electric
, Gasoline
, Diesel
, or Hydrogen
.
Shown on Google.
fuel_efficiency
Optional
String
Highway MPG, City MPG, and Combined MPG. For EVs, this attribute can also be used for the EPA's MPG-equivalent rating.
For example, 22 / 27
or 62 / 64 / 63
.
Shown on Google.
ev_battery
Optional
String
Battery specification for an EV.
For example, 100 kWh 350V lithium-ion
Not shown on Google, but may be used to improve data quality.
ev_range
Optional
String
Range for an EV
Not shown on Google, but may be used to improve data quality.
transmission
Optional
String
Transmission specification
For example, 9-speed automatic
or manual
.
Shown on Google.
num_doors
Optional
Int
Number of doors
Shown on Google.
legal_disclaimer
Optional
String, maximum 3k characters
Recommended or legally required disclosures, such as additional taxes or fees. This helps users make informed decisions when they make a purchase. Keep in mind that it's your responsibility to comply with all applicable laws and regulations, and to ensure that all information you provide is accurate.
Shown on Google.
seating_capacity
Optional
Int
Number of seats
Shown on Google.
seating_rows
Optional
Int
Number of seating rows
Not shown on Google, but may be used to improve data quality.
co2_emission
Optional
String
CO 2 emission
Not shown on Google, but may be used to improve data quality.
description
Optional
String
Free text field for additional information about the vehicle, such as whether it's single owner, has no accidents, or similar.
Not shown on Google, but may be used to improve data quality.
vehicle_fulfillment
Optional
Enum
The vehicle's status. Use one of the following values:
-
IN_STORE: The vehicle is present at the dealer's location. -
SHIP_TO_STORE: The vehicle is in transit or at another location, such as another dealer, but can be transferred to this dealer. -
ONLINE: The vehicle can exclusively be delivered to the customer.
Not shown on Google, but may be used to improve data quality.
vehicle_location
Optional
String
The actual location of the car, if different from the dealer
location. For example, Ford of Mountain View, 1800 Amphibious
Blvd., Mountain View, CA 94045
Not shown on Google, but may be used to improve data quality.
vehicle_history_report_link
Optional
URL
Link to a vehicle's history report, such as CARFAX
Shown on Google.
monroney_sticker
Optional
URL
Link to the Monroney sticker for this vehicle
Not shown on Google, but may be used to improve data quality.
