|
|
Send a Listings Feed
<< back to feed page
Sample Vehicle Feed Files
Oodle accepts vehicle feed files in the CSV, Tab-Delimited, or XML formats. Here is a sample feed file for each of these formats:
CSV
Tab-Delimited
XML
Vehicle Fields
Required Fields
Each vehicle listing needs to include these fields.
Location Fields
The location fields indicate the location of the item being listed. For location-based search to work, it is highly recommended that each listing specify its location at least down to the city or zip/postal code level.
Additional Fields
The more of these additional fields that are included for a listing, the more likely that listing is to be found in searches.
Field Descriptions
| address |
| The street address of the listing. |
|
Format:
Text.
|
|
Example:
3459 Oak Street
|
| body_type |
| The car body type. |
|
Format:
Text. Should correspond to common names for car body types.
|
|
Example:
sedan
|
| category |
| The category of the item being listed. Here are some such categories. |
|
Format:
Text. Please be consistent in category names.
|
|
Example:
Cars
|
| city |
| The name of the city. Please use an official postal city name. |
|
Format:
Text.
|
|
Example:
Concord
|
| color |
| The exterior color of the vehicle. |
|
Format:
Text.
|
|
Example:
orange
|
| condition |
| The condition of the item being listed. |
|
Format:
Text. Allowed values are: new, used, certified pre-owned.
|
|
Example:
used
|
| country |
| The country abbreviation. |
Format:
Text. Preferably, the two letter ISO 3166 country code. |
|
Example:
US
|
| create_time |
| The date/time at which the listing was created. |
|
Format:
YYYY-MM-DD, or RSS format (i.e. 2004-07-16T14:00:00-07:00).
|
|
Example:
2004-07-16T14:00:00-07:00
|
| currency |
| The ISO 4217 three-letter currency code for the currency used in this listing. |
|
Format:
Text. By default, such fields as price and salary are assumed to be specified in the currency of the country the listing is located in, and this is sufficient for the vast majority of listings. Use this field to override this assumption.
|
|
Example:
USD
|
| dealer |
| The name of the dealer selling the vehicle. |
|
Format:
Text.
|
|
Example:
Smith Automotive
|
| dealer_email |
| The email of the dealer selling the vehicle. |
|
Format:
Text.
|
|
Example:
joe@smithautomotive.com
|
| dealer_phone |
| The phone number of the dealer selling the vehicle. |
|
Format:
Text.
|
|
Example:
123-456-7890
|
| dealer_url |
| The URL of the dealer selling the vehicle. |
|
Format:
Fully qualified url.
|
|
Example:
http://www.smithautotive.com/
|
| description |
| A description of the listing. |
|
Format:
Text. Maximum length 20,000 bytes.
|
|
Example:
Gently used car. Still has all original manuals.
|
| engine_type |
| The engine type of the vehicle being listed. |
|
Format:
Text.
|
|
Example:
|
| expire_time |
| The date/time at which the listing expires. |
|
Format:
YYYY-MM-DD, or RSS format (i.e. 2004-09-16T14:00:00-07:00).
|
|
Example:
2004-09-16T14:00:00-07:00
|
| featured |
| Indicates that a particular listing should be featured. This field only works if prior arrangements have been made with Oodle. |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| features |
| The set of other characteristics the pet has. |
|
Format:
Text. Allowed values include: air bags, air conditioning, am/fm stereo radio, antilock brakes, arm rests, ball or receiver hitch, beverage holder, center console, cd player, climate control, clock, cruise control, directional mirrors, dual power mirrors, dual power seats, front bucket seats, heated seat(s), homelink system, interval wipers, keyless entry, leather upholstery, memory seats, moon roof, navigation system, passenger climate control, power brakes, power door locks, power steering, power windows, premium sound system, premium wheels, radial tires, rear defroster, reclining seats, roof rack-luggage rack, running boards, sun roof, tachometer, tilt steering wheel, trip computer or compass, trip odometer.
|
|
Example:
air conditioning, air bags, cruise control, clock, radio
|
| fee |
| Listing requires a fee to view the content (ie. requires registering at a fee-based site). |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| fuel_type |
| The type of fuel which the vehicle uses. |
|
Format:
Text. Allowed values include: bio-diesel, diesel, electric, gasoline, hydrogen, natural gas, other.
|
|
Example:
diesel
|
| id |
| Unique ID for this listing. You must use the same id with a listing in subsequent versions of the feed. |
|
Format:
Text.
|
|
Example:
3916251
|
| image_url |
| A URL pointing to a full-sized (not thumbnail) image of the vehicle being listed. We will reduce the image to an appropriately-sized thumbnail. The image should be the specific vehicle being listed, so please do *not* include logos, stock photos or 'image unavailable' images. Multiple image URLs can be included by pipe-separating the URLs. |
|
Format:
Fully qualified URL(s) that points to an image.
|
|
Example:
http://www.example.com/listing/image1.jpg|http://www.example.com/listing/image2.jpg
|
| interior_color |
| The color of the interior of the vehicle being listed. |
|
Format:
Text.
|
|
Example:
blue
|
| ip_address |
| The IP address of the user that the listing was posted from. |
|
Format:
IPv4 address in dot-decimal notation.
|
|
Example:
142.72.8.120
|
| latitude |
| Latitude, in degrees. |
|
Format:
Number.
|
|
Example:
37.5537
|
| length |
| The length of the vehicle, in feet (this attribute is particularly for Boats) |
|
Format:
Number.
|
|
Example:
27
|
| longitude |
| Longitude, in degrees. |
|
Format:
Number.
|
|
Example:
-122.3038
|
| make |
| The make of the item being listed. |
|
Format:
Text.
|
|
Example:
Honda
|
| material |
| The material of which the vehicle is made. |
|
Format:
Text. Allowed values include: Aluminum, Ferro-Cement, Fiberglass, Hypalon, Inflatable, Other, Plastic, PVC, Rigid Inflatable, Steel, Wood
|
|
Example:
Aluminum
|
| mileage |
| Mileage of vehicle. |
|
Format:
Number.
|
|
Example:
114682
|
| mileage_units |
| The units of mileage of the vehicle. |
|
Format:
Text. Allowed values are: miles, km, hours (eg. for boats and airplanes).
|
|
Example:
miles
|
| model |
| Vehicle model. |
|
Format:
Text.
|
|
Example:
Civic
|
| neighborhood |
| Neighborhood name. |
|
Format:
Text.
|
|
Example:
Willow Park
|
| price |
| The price of the listing. Note that a price of zero (0) means free. If the price is unknown or not specified, then do not include this field or leave it blank. For auction items this should be the buy-it-now price. |
|
Format:
Floating-point number. Please use the an optional decimal point (.), rather than the comma, to indicate cents. If a dash (-) is included between two such numbers, then the price is treated as a price range.
|
|
Example:
2790.00
|
| private_party |
| Indicates whether this listing is being made by an individual (private party). |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
no
|
| registration |
| Listing requires registering at a site to view the content. |
|
Format:
Text. Allowed values are: yes, no.
|
|
Example:
yes
|
| secondary_source |
| The name of the original source of the listings, if it is other than the provider of this feed. |
|
Format:
Text.
|
|
Example:
Pleasanton Listings
|
| seller_email |
| The email of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
joe@smith.com
|
| seller_name |
| The name of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
Joe Smith
|
| seller_phone |
| The phone number of the actual seller of the listing. |
|
Format:
Text.
|
|
Example:
123-456-7890
|
| seller_type |
| The type of seller of this vehicle. |
|
Format:
Text. Allowed values are: dealer, private_party.
|
|
Example:
private_party
|
| seller_url |
| The URL of the actual seller of the listing. |
|
Format:
Fully qualified url.
|
|
Example:
http://smith-classifieds.com/
|
| state |
| The abbreviation for the province or state. |
|
Format:
Text. Please use standard abbreviations where possible.
|
|
Example:
CA
|
| title |
| The title of the listing. |
|
Format:
Text.
|
|
Example:
Used 1990 Honda Civic for sale.
|
| transmission |
| The type of transmission. |
|
Format:
Text. Allowed values are: standard, automatic.
|
|
Example:
automatic
|
| trim |
| The trim color of the car. |
|
Format:
Text.
|
|
Example:
silver
|
| url |
| The URL of the details page for this listing. This URL must have relevent information about the listing. |
|
Format:
Fully qualified url.
|
|
Example:
http://www.example.com/listing/details.html
|
| vin |
| Vehicle identification number. |
|
Format:
Text.
|
|
Example:
WDBFA67D5SF118569
|
| year |
| The year the vehicle was built. |
|
Format:
Four-digit year.
|
|
Example:
2001
|
| zip_code |
| The postal code or zip code of the listing. |
|
Format:
Text. Please use a format standard to the postal codes of the country in question.
|
|
Example:
94772
|
<< back to feed page
|
