Feed specification

The following table defines the attributes that you can include in a feed.

Attributes
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.

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

Required where 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

Required for 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.

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

CO2 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.

monroney_sticker

Optional

URL

Link to the Monroney sticker for this vehicle

Not shown on Google, but may be used to improve data quality.