Feed Specification

Feed Format

Feeds should be uploaded in the CSV or TSV (comma or tab-separated values) format:

  • The CSV format should conform to RFC 4180:
    • Data providers can use custom separators instead of commas / horizontal tabs,
    • Double-quotes should not appear anywhere in the file unless they are escaped:
      • To escape a double-quote, use two double-quotes and additionally enclose the entire CSV field in double-quotes (refer to sections 2.5-2.7 in RFC 4180),
      • An example valid usage of double-quotes is “Wheels 17”” Alloy”, which will be displayed as Wheels 17” Alloy
  • Data providers can optionally compress the file using the zip or gz format,
  • The feed should contain a single file - sharding (i.e. multiple file fragments) is not supported,
  • Every feed version should contain the full inventory of each dealership (partial inventory updates are not supported).

Feed Specification

Type Attribute Description Content
Required VIN Vehicle Identification Number, unique identifier for each car String, 17 digits
Optional id Internal unique stock number for each car String
Required store_code Unique alphanumeric identifier for each dealership String
Optional place_id Place ID of the dealership’s Business Profile

Note: Place type must be a car_dealer
String
Optional maps_url Google Maps URL of the dealership’s Business Profile

Example supported URL:
https://www.google.com/maps/place/Googleplex/ data=!4m2!3m1!1s0x0:0x6c296c66619367e0

Example unsupported URLs:
https://goo.gl/maps/Sda1ubveK2WVC3E3A
https://www.google.com/search?q=Googleplex
URL
Required dealership_name Full dealership name (business name) e.g. Ford of Mountain View String
Required dealership_address Full dealership address (including the city, postal code and country) e.g. 1600 Amphitheatre Pkwy, Mountain View, CA 94043, US String
Optional dealership_email Dealership’s email address Email
Optional dealership_phone Dealership’s telephone number Telephone number
Optional tracking_phone_number Phone number used for the cars for sale experience.

Note: This will not change the dealer's phone number on their Business Profile.
Telephone number
Optional (though preferred) image_link The main image for the car.

Note: Googlebot must be allowed to crawl the page. Missing links may cause the car to be ranked lower.
URL
Optional (though preferred) additional_image_link Additional images for the car URL, repeated
Optional 360_image_exterior 360 image list of the vehicle exterior URL, repeated
Optional 360_image_interior 360 image list of the vehicle interior URL, repeated
Optional (though preferred) link Link to the dealer’s VDP (Vehicle Details Page)

Note: Googlebot must be allowed to crawl the page. Missing links may cause the car to be ranked lower.
URL, UTM/tracking parameters are permitted
Optional additional_link Additional VDP (Vehicle Details Page) links e.g. from online marketplaces URL, repeated
Optional date_in_stock The date when the car was first available for sale Date, e.g.
  • 2020-01-31
Required price The (final) sale price for the car

Number plus currency (use ISO 4217)
Price, e.g.
  • 10499 USD
  • 10,499.00 USD
Required (for new cars) vehicle_msrp MSRP for vehicle in current configuration, only applicable for New

Number plus currency (use ISO 4217)
Price, e.g.
  • 10499 USD
  • 10,499.00 USD
Required condition New / Used String
  • n, new
  • u, used
Optional certified_pre_owned Car is OEM certified pre-owned

Note: Only applicable for used cars
Boolean
  • 1, y, yes
  • 0, n, no
Required make Make of the car e.g. Toyota String
Required model Model of the car e.g. Civic without trim specifics such as LX, EX, etc String
Required (where available) trim Trim of the model e.g. S, SV, SL String
Required year Model year Int (4 digit)
Required (for used cars) mileage Number of miles on the vehicle

Note: The unit defaults to miles
Int + Unit, e.g.
  • 2333
  • 52,777 miles
Required exterior_color OEM specified exterior color e.g. White, Platinum, Metallic Tri-Coat String
Optional exterior_color_generic Generic color e.g. black, red String
Optional interior_color OEM specified exterior color e.g. Brown, Ivory String
Optional interior_color_generic Generic color e.g. black, red String
Optional body_style Sedan, SUV, Crossover, etc. String, e.g.
  • convertible
  • coupe
  • crossover
  • full size van
  • hatchback
  • minivan
  • sedan
  • station wagon
  • suv
  • truck
Required vehicle_option Separated list of standard equipment as well as installed options and packages, e.g. Leatherette Seats,Rear View Camera, Navigation System,Front Seat Heaters,A/C,Sunroof,Bluetooth String, repeated
Optional drive_train Drivetrain specification String, e.g.
  • FWD
  • RWD
  • AWD
  • 4WD
Optional engine Engine specification String, e.g.
  • 5.0L V8 510 hp@6000rpm
Optional fuel Fuel type String, e.g.
  • Electric
  • Gasoline
  • Diesel
  • Hydrogen
Optional fuel_efficiency Highway MPG, City MPG, Combined MPG String, e.g.
  • 22 / 27
Optional ev_battery Battery specification String, e.g.
  • 100 kWh 350V lithium-ion
Optional ev_range EV range String
Optional transmission Transmission specification String, e.g.
  • 9-speed automatic
  • manual
Optional num_doors Number of doors Int
Optional legal_disclaimer Recommended or legally required disclosures, such as additional taxes or fees. This helps users make informed decisions when making a purchase. Keep in mind that you are responsible for complying with all applicable laws and regulations, and for ensuring that all information you provide is accurate. String (max 3k chars)
Optional seating_capacity Number of seats Int
Optional seating_rows Number of seating rows Int
Optional co2_emission CO2 emission String
Optional description Free text field for additional information about the car, such as single owner, no accidents, and similar String
Optional disclosure_text Text disclosure information (e.g. "Vehicle prices exclude..."). Not to be used for marketing / promotions. String
Optional disclosure_url Link to disclosure information (e.g. financing offer disclosure, on merchant website) URL
Optional warranty Warranty terms and conditions String or URL
Optional vehicle_fulfillment The car's transferability status:
  • IN_STORE: The car is present at the dealer’s location.
  • IN_TRANSIT: The car is in transit to the dealer’s location.
  • SHIP_TO_STORE: The car is at another location (e.g., another dealer), but can be transferred to this dealer.
Enum. One of:
  • IN_STORE
  • IN_TRANSIT
  • SHIP_TO_STORE
Optional vehicle_location The actual location of the car, if different from the dealer location, e.g.: Ford of Mountain View, 1600 Amphitheatre Pkwy, Mountain View, CA 94043 String
Optional history_report Link to vehicle history report, e.g. CarFax URL
Optional monroney_sticker Link to Monroney sticker for this vehicle URL