Feed specification

Stay organized with collections Save and categorize content based on your preferences.

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

Attributes
vin

Required

String, 17 alphanumeric characters

Vehicle Identification Number, a unique identifier for each vehicle.

id

Optional

String

An internal stock number that's unique for each vehicle.

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.

place_id

Optional

String

The Place ID of the dealership's Business Profile.

maps_url

Optional

URL

Google Maps URL of the dealership's Business Profile

For more details, see Match with Google Maps URLs.

dealership_name

Required

String

Full dealership name (business name), such as Ford of Mountain View

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

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.

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.

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.

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.

condition

Required

String

The condition of the vehicle, either new or used. We accept the following values:

  • New: n, new
  • Used: u, used
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
make

Required

String

Make of the vehicle, such as Toyota.

model

Required

String

Model of the vehicle, such as Civic. Don't include trim specifics like LX or EX.

trim

Required where available

String

Trim of the model, such as S, SV, or SL.

year

Required

Int

Model year in the format YYYY.

mileage

Required for used vehicles

Int + Unit

Number of miles on the vehicle. For example, 2333 or 52,777 miles.

exterior_color

Recommended

String

OEM-specified exterior color, such as White, Platinum, or Metallic Tri-Coat.

exterior_color_generic

Optional

String

Generic exterior color, such as black or red.

interior_color

Optional

String

OEM-specified interior color, such as Brown or Ivory.

interior_color_generic

Optional

String

Generic interior color, such as black or red.

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

drive_train

Optional

String

Drivetrain specification of the vehicle

For example, FWD, RWD, AWD, or 4WD.

engine

Optional

String

Engine specification of the vehicle

For example, 5.0L V8 510 hp@6000rpm

fuel

Optional

String

Fuel type of the vehicle

For example, Electric, Gasoline, Diesel, or Hydrogen.

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.

ev_battery

Optional

String

Battery specification for an EV.

For example, 100 kWh 350V lithium-ion

ev_range

Optional

String

Range for an EV

transmission

Optional

String

Transmission specification

For example, 9-speed automatic or manual.

num_doors

Optional

Int

Number of doors

seating_capacity

Optional

Int

Number of seats

seating_rows

Optional

Int

Number of seating rows

co2_emission

Optional

String

CO2 emission

description

Optional

String

Free text field for additional information about the vehicle, such as whether it's single owner, has no accidents, or similar.

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

monroney_sticker

Optional

URL

Link to the Monroney sticker for this vehicle