Bulk upload Car Listings for Auto Dealers

Bulk upload service provides car dealers and dealerships with free bulk upload of car listings to GVANGA.
You provide us with XML file containing your current vehicle offers and your ads will be imported to GVANGA and updated on a daily basis. As an extra, we add manufacturer specs for each of advertised car for free. 
To start using our automatic bulk listing service please sign up as a new user on GVANGA and submit a link to your XML file in My Account area.

Steps for connection to the service:

Step 1: Create an XML file (feed) - a structured, updated data file on your site. The supported format is specified below. 

Step 2: Registration on Gvanga.com. To upload the XML feed, you need to be a registered user of our site. Please note that the XML Feed Import service is only available for companies.

Step 3: Submit a URL of the XML feed. You can fill out the feedback form below or send a link to your XML feed from the “My Account” page under “XML Feeds”.

After you add your XML feed, it will be verified and checked by our moderators.
When approved, the data from your XML feed will be automatically uploaded and updated on our website once per day. In “My Account” page under “Ads from XML file” tab, you can manage the imported ads.

 

Feed Requirements 

Please note that all ads loaded from your XML file must comply with our Posting Policy. Avoid duplicating contact information and links to online resources in your ad text (<description>), and the availability of contact information and watermarks on images in your feed.
Relevance - feed should contain only relevant data on ads.
Editing previously imported ads should be implemented by updating previously existing data. 

Technical requirements for your feed

  • Feed URL must be permanent and accessible via HTTP.
  • Feed should be created in UTF-8.
  • HTML-code is not allowed.
  • The first 32 characters of the ASCII codes (except for the numbers 9, 10 and 13) should not be used in the text boxes.
  • In addition, some character should be replaced by codes as noted below:

 

CharacterCode
"             &quot;
&            &amp;
>             &gt;
<             &lt;
'              &apos;

 

XML Feed format​

Each XML document should begin with an XML declaration: 
<?xml version="1.0" encoding="utf-8"?>

XML file must contain the root element 'catalog' with the feed creation date:
<catalog generated="YYYY-MM-DD HH:mm+02:00">...</catalog>

Each ad is formed by the element 'offer', for which you need to define a unique ID in the file.

 

Required Fields

Element NameDescription
<id>a unique ID for a particular ad
<make>Car Make
<model>Car Model
<year>Car's model year (the date format: YYYY)
<bodyType>

Fixed text string. Select a car body type from the list:

'Sedan'
'Sedan-hardtop'
'Hatchback'
'Liftback'
'Van'
'Pickup Single Cab'
'Pickup Double Cab'
'Pickup Single and Half Cabin
'Pickup'
'Coupe-hardtop
'Coupe'
'Convertible'
'SUV'
'Roadster'
'Speedster'
'Compact van'
'Limousine'

<color>

Choose a colour from the list:

'Black'  
'Yellow'      
'Green'      
'Blue'      
'Red'      
'Orange'      
'Light Blue'      
'Violet'      
'Pink'
'Eggplant'      
'White'
'Grey'  
'Silver'  
'Brown'  
'Dark Blue'  
'Beige'
'Golden'
'Dark Green'
'Cherry'

<doors>Number of doors (an integer > 0)
<steeringWheel>Steering wheel arrangement ('LHD', 'RHD')
<gearBox>Type of Car Transmission ('CVT', 'AT', 'MT')
<engineCapacity>Engine capacity (an integer and fractional part with one decimal digit, e.g., 1.6). You can define the unit of capacity by the attribute 'unit': 'l' or 'cm3'. The default is liters.
<horsePower>Horse power (an integer > 0, without spaces)
<driveTrain>Drive train ('Rear WD', 'Front WD', '4WD')
<engineType>Engine type ('Diesel', 'Gasoline', 'Hybrid')
<title>Ad title
<description>Ad description (Free text string)
<condition>

Car's condition. Fixed text string. Choose the condition from the list:

'new'
'used'
'under warranty'
'salvage'
'for parts'

<price>Selling price (an integer > 0, without spaces)
<currency>Currency: an alphabetic currency code from the ISO 4217 code list
<seller>

Parent element for the contact details of the agent:

<seller>
    <companyName>Agency</companyName>
    <name>Philip</name>
    <phone>123-465-789</phone>
    <email>agent@agency.org</email>
</seller>

Required field is marked below with an asterisk.

<companyName>Company name
<name>Contact name
<phone>Phone number
<email>*E-mail address
<type>Seller type ('Owner', 'Dealer', 'Company'). The default is 'Dealer'.
<location>

Parent element used to describe the car location:

<location>
    <country>USA</country>
    <region>New Jersey</region>
    <city>Jersey City</city>
    <address>New street, 1</address>
</location>

Required field is marked below with an asterisk.

<country>*The name of the country
<region>The name of the region, district, state
<city>*The name of the city
<address>Address where the car is located

 

Additional Fields​

It is recommended to include more elements in each offer for a better conversion and ranking in our search results.

Element NameDescription
<url>A single URL for each ad
<imageUrl>URL to a photo of the car (tag single element should be added for each image, up to 4 tags can be added for each car). 
<updateDate>Date last update of the ad (the date format: YYYY-MM-DDTHH:mm+02:00)
<paymentMethod>Method of payment. Free text string.
<vin>A vehicle identification number (VIN)
<odometer>Odometer km/miles (an integer > 0, without spaces). You can define the unit of odometer by the attribute 'unit': 'km' or 'm'. The default is kilometers.
<generation>A particular generation of vehicle (II, E70, etc.)
<paintType>

Paint type. Fixed text string. Choose the type of paint from the list:

'Glossy'
'Metallic'
'Matt'
'Multicolor'
'Airbrushing'

<customs>Customs clearance (a boolean value. If YES use one of the values: 'yes', '1', '+', 'true', if NO use one of the values: 'no', '0', '-', 'false')
<armored>Boolean: If YES use one of the values: 'yes', '1', '+', 'true', if NO use one of the values: 'no', '0', '-', 'false'
<interiorFeatures>Parent element used to describe the car interior features
<interiorMaterials>

Interior Materials. Fixed text string. Choose the type of materials from the list:

'Leather'
'Faux leather'
'Suede'
'Velour'
'Aluminium'
'Carbon'
'Wood'
'Plastic'

Separate different types with a comma in the case of a multiple choice.

<seatMaterial>

Seat Materials. Fixed text string. Choose the material from the list:

'Leather'
'Faux leather'
'Suede'
'Velour'
'Alcantara'
'Fabric'

Separate different types with a comma in the case of a multiple choice.

<interiorColor>

Interior Color. Fixed text string. Choose the color from the list:

'Black'
'Grey'
'White'
'Brown'
'Beige'
'Red'

Separate different colors with a comma in the case of a multiple choice.

 
<safetyFeatures>
 
Parent element used to describe car safety features.
<activeSafety>

Active Safety SystemsFixed text string. Choose the features from the list:

'Emergency Unlocking in case of accident'
'ABS - Anti-lock braking system'
'Traction Control System'
'Electronic Stability Control'
'Vehicle Dynamic Control'
'Emergency Brake Assist'
'EBD - Electronic brakeforce distribution'
'Electronic Differential Lock'
'System to prevent unintended acceleration'
'Pedestrian Detection System'
'Downhill Assist Control'
'Hill Start Assist'
'Blind Spot Monitor'
'Driver Impairment Monitor'
'Park Assist'
'Automated Parking System'

Separate different features with a comma in the case of a multiple choice.

<parkingSensors>

Parking Sensors. Fixed text string. Specify 'Front' or/and 'Rear' parking sensors (separate text with a comma if both).

<passiveSafety>

Passive Safety SystemsFixed text string. Choose the features from the list:

'Seat Belt Pretensioner'
'Front Airbags for driver and front seat passenger'
'Side Airbags for driver and front seat passenger'
'Curtain Airbags'
'Knee Airbags'
'Central Airbag'
'ON-OFF switch for front passenger's airbag'
'Child Seat Anchors'
'Pedestrian Airbags'

Separate different features with a comma in the case of a multiple choice.

<camera>Camera. Fixed text string. Specify 'Rear-View' or/and 'Front View' camera (separate text with a comma if both).
<securitySystems>

Security Systems. Fixed text string. Choose the features from the list:

'Central Locking System'
'Engine Immobilizer'
'Keyless Entry Controller'
'Intelligent Access Key'
'Car Alarm'
'Power Door Lock'
'Rear Door Child Safety Locks'

Separate different features with a comma in the case of a multiple choice.

 

 

 

 

<equipmentSensors>

On-Board Equipment and Sensors. Fixed text string. Choose the features from the list:

'On-Board Computer'
'Cruise Control'
'Adaptive Cruise Control'
'Light Sensor'
'Rain Sensor'
'Temperature Sensor'
'Cigarette Lighter'
'Power Outlet'
'Rear Fog Lights'
'Mirror Heater'
'Heated Windshields'
'Headlight Washer System'

Separate different features with a comma in the case of a multiple choice.

 
<adjustments>
 
Parent element used to describe car adjustments.
<steeringWheel>

Steering Wheel. Fixed text string. Choose the features from the list:

Height Adjustment
Distance Adjustment
Electric Adjustment

Separate different features with a comma in the case of a multiple choice.

<mirrorAdj>Mirror Adjustment. Fixed text string. Specify 'Manual Mirror Adjustment' or 'Power Mirrors'.
<driversSeatAdj>

Driver's Seat Adjustment. Fixed text string. Choose the features from the list:

'Seat Height Adjustment'
'Longitudinal Adjustment'
'Lumbar Support Adjustment'
'Power Seat'
'Driver Multi-Adjustable Power Seat'
'Memory Function'
'Reclining Angle Adjustment Device'

Separate different features with a comma in the case of a multiple choice.

<passengersSeatAdj>

Passenger's Seat Adjustment. Fixed text string. Choose the features from the list:

'Seat Height Adjustment'
'Longitudinal Adjustment'
'Reclining Angle Adjustment Device'
'Power Seat'

Separate different features with a comma in the case of a multiple choice.

<powerWindows>Power Windows. Fixed text string. Specify 'Front' or/and 'Rear' power windows. (separate text with a comma if both).
 

<comfort>

 

Parent element used to describe Car Comfort Features

<climateControl>Climate Control. Fixed text string. Specify: '1-zone', '2-zone' or '3-zone'.
<powerSteering>Power Steering. Fixed text string. Specify: 'Hydraulic Power Steering' or 'Electric Power Steering'
<additional>

Additional Comfort Features. Fixed text string. Choose the features from the list:

'Air Conditioning'
'Cabin Air Filter'
'Air Quality Sensors'
'Heated Steering Wheel'
'Heated Front Seats'
'Heated Rear Seats'
'Cooled Seats'
'Massage Cushions'

Separate different features with a comma in the case of a multiple choice.

 

<multimediaNavi>

 

Parent element used to describe Multimedia and Navigation Car Features.

<equipment>

Multimedia and Navigation Equipment. Fixed text string. Choose the features from the list:

'Speakers'
'CD/MP3'
'AM/FM'
'USB Connector'
'Audio Jack'
'iPod Dock'
'Speakerphone'
'Subwoofer'
'Audio and Cruise Controls on Steering Wheel'
'Navigation System'
'Video Monitor'
'DVD'
'TV'

Separate different features with a comma in the case of a multiple choice.

<speakersQty>

Specify the number of Car Speakers.
 

<additionalFeatures>

 

Parent element used to describe additional car features.

<equipment>

Additional Equipment. Fixed text string. Choose the features from the list:

'Sunroof'
'Panorama Roof'
'Alloy Wheels'
'Trailer Hitch'
'Window Tint'

Separate different features with a comma in the case of a multiple choice.

<wheelSize>Specify the wheel size.

Example of XML feed:

<catalog generated="2016-02-05 17:24">
<offers>
<offer>
<!--
The following attributes are mandatory for each item
-->
<id>1</id>
<title>BMW 325 2.5 AT 2001</title>
<make>BMW</make>
<model>3er</model>
<bodyType>Coupe</bodyType>
<doors>2</doors>
<engineType>Gasoline</engineType>
<gearBox>AT</gearBox>
<driveTrain>Rear WD</driveTrain>
<engineCapacity unit="l">2.5</engineCapacity>
<horsePower>192</horsePower>
<year>2001</year>
<steeringWheel>LHD</steeringWheel>
<color>Black</color>
<condition>used</condition>
<description>
Excellent features sports seats in leather red ABS ESP ZVFB Cruise Control Chrome package center armrest board computer Raucherpaket Tinted windows 4x FH loading space cover leather steering wheel PDC rear tire Control System Radio with MP3 light and sight package interior mirror with Abbendaitomatik rain sensor DRL Winter package Heated seats Met Paint No Rust Top maintained vehicle
</description>
<price>4000</price>
<currency>USD</currency>
<seller>
<companyName>AutoDealer LTD</companyName>
<name>Joe</name>
<phone>123-456-789</phone>
<email>joe@autodealerltd.com</email>
<type>Dealer</type>
</seller>
<location>
<country>USA</country>
<region>Florida</region>
<city>Miami</city>
<address>Street, 2</address>
</location>
<!--
The following attributes are not required, but strongly recommended
-->
<url>https://gvanga.com/en/ukraine/any/category/cars/bmw/1/</url>
<paymentMethod>Credit Card, Prepaid</paymentMethod>
<imageUrl>https://gvanga.com/img/a/original/488406_bmw-3-seriya-320i-20-at-184-ls-2012-g.jpg</imageUrl>
<updateDate>2016-11-29 15:40</updateDate>
<generation>E46</generation>
<vin>JN1WNYD21U0000001</vin>
<odometer unit="m">150000</odometer>
<paintType>Metallic</paintType>
<customs>true</customs>
<armored>true</armored>
<interiorFeatures>
<interiorMaterials>Wood,Plastic</interiorMaterials>
<seatMaterial>Leather,Faux leather</seatMaterial>
<interiorColor>Black,Grey,White</interiorColor>
</interiorFeatures>
<safetyFeatures>
<activeSafety>
ABS - Anti-lock braking system,Electronic Stability Control,Emergency Brake Assist,Electronic Differential Lock,Pedestrian Detection System,Hill Start Assist,Driver Impairment Monitor,Automated Parking System
</activeSafety>
<parkingSensors>Rear</parkingSensors>
<passiveSafety>ON-OFF switch for front passenger's airbag</passiveSafety>
<camera>Rear-View</camera>
<securitySystems>Car Alarm</securitySystems>
</safetyFeatures>
<equipmentSensors>
<equipment>On-Board Computer,Rain Sensor</equipment>
</equipmentSensors>
<adjustments>
<steeringWheel>Distance Adjustment</steeringWheel>
<mirrorAdj>Manual Mirror Adjustment</mirrorAdj>
<driversSeatAdj>Seat Height Adjustment,Memory Function</driversSeatAdj>
<passengersSeatAdj>Power Seat</passengersSeatAdj>
<powerWindows>Front</powerWindows>
</adjustments>
<comfort>
<climateControl>3-zone</climateControl>
<powerSteering>Electric Power Steering</powerSteering>
<additional>Cabin Air Filter,Cooled Seats</additional>
</comfort>
<multimediaNavi>
<equipment>CD/MP3,AM/FM</equipment>
<speakersQty>4</speakersQty>
</multimediaNavi>
<additionalFeatures>
<equipment>Sunroof,Window Tint</equipment>
<wheelSize>16</wheelSize>
</additionalFeatures>
</offer>
</offers>
</catalog>

 

 

We also accept files in other formats. You can send us your file and we will consider the possibility of the data import in your format.
If you have questions and suggestions regarding upload of XML ads on GVANGA.COM, please contact us via contact form below.

Feedback

Required fields are marked *