Deprecated: __autoload() is deprecated, use spl_autoload_register() instead in /var/www/sites/public_html/wiju.com/core/common/functions.inc.php on line 7
Contact - Wiju

Cars Feed

If you have a webpage with published ads, you can include them in Wiju! It is very simple:

  1. Create an XML file following the format guidelines specified below.
  2. Send us the URL where your feed is located (For example: http://www.yourdomain.com/wiju_feed.xml) using our contact form.

From that moment, we will periodically read your feed to insert new ads, make the appropiate changes and expire the ads that are no longer present in your feed.

Your ads will be included in Wiju's search results as soon as possible.

If you have any questions do not hesitate to contact us.

XML Feed Format

These are the instructions for creating an XML feed to include your ads in Wiju. If you find it convenient, you can use our XSD Schema that describes the structure of the feed. If you need more information on the XML format we recommend that you consult Wikipedia.

The file must be encoded in UTF-8

The XML file will have a main <wiju> tag that will collect a set of ads represented by the <ad></ad> tags. Each <ad></ad> block contains required and optional fields:

REQUIRED FIELDS

The required fields are the set of XML tags that provide the minimum amount of informatioin necessary for our systems to include your ads in Wiju.

  • id: ID of the ad on your page (can be numeric or alphanumeric, but must be unique, because we use the ID to avoid duplicate ads).
  • url: URL of the ad on your website.
  • title: Title of the ad.
  • content: Description of the ad (minimum 30 characters). Remember that the better the description, the bigger your audience will be!

OPTIONAL FIELDS

Optional fields should not be added if they have no content. But if you have these fields on your website, please include them in your feed. Wiju's ordering algorithm prioritizes quality, so the more complete the ad is, the better its position will be!

  • price: Price of the car.

    When the price is specified in a currency other than the country's official currency, you must use the 'currency' attribute. The values are determined by the ISO-4217 specification. Thus, Wiju will convert the value to official currency.

    <price currency="USD"><![CDATA[...]]></price>

    This would specify the price of a car in dollars. Do not include currency symbol next to the price. See technical specifications for details.

  • car_type: Literal information about the type of car (for example: Chrysler, 4x4, convertible, sedan, SUV, van, etc.)
  • city: City where the car is located.
  • region: Name of the region / state where the car is located.
  • postcode: Zip Code where the car is located.
  • brand: Car make.
  • model: Car model.
  • year: Year of manufacture of the car. The correct format is YYYY.
  • mileage: Mileage of the car. If not specified the unit of measure is determined by means of the default local unit. You can specify the unit of measure with the attribute 'unit':
    <mileage unit="kilometers"><![CDATA[...]]></mileage>
    

    The available values for 'unit' are: "kilometers" or "miles".

  • doors: Number of doors.
  • fuel: Literal information on the fuel the car uses (for example: diesel, gas, etc.) * Diesel * Gas * Petrol * Electric * Hybrid
  • transmission: Literal information about the transmission type of the car (for example: manual, automatic, semi-automatic, etc.) * Manual * Automatic
  • latitude: Latitude where the car is located. Refer to technical specifications for details.
  • length: Length where the car is located. Refer to technical specifications for details.
  • pictures: This tag includes the different images of the car.

    The field that defines a particular image is <picture>:

    • picture: This tag includes the fields for the URL and the title of the image (the title is optional).

      The fields that must be defined within the <picture> element are:

      • picture_url: URL where the picture is located.
      • picture_title: Title of the picture.
    <pictures>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
    
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
            ...
    </pictures>
    

    The image shown in Wiju for a specific ad will be the first of the set of images.
    You should choose the most relevant image as the first one because it will have great influence on user clicks.

    Wiju does not allow the inclusion of corporate pictures with the "Picture not available" message.
    If this is detected, Wiju reserves the right to block your ads.

    Once your ads are inserted in Wiju, the images associated with them cannot be modified even in the next reading of your feed.
    Make sure the new ads you add to your feed have the correct images.

  • date: Date the ad was posted. The correct format is DD/MM/YYYY.
  • time: Time the ad was posted. The correct formats are HH:MM or HH:MM:SS.
  • expiration_date: Date the ad will expire. The correct format is DD/MM/YYYY.

The following field must be filled according to if it is true or false. Refer to technical specifications to know what values represent true and false values.

  • is_new: Is the car new or used?

The XML feed will look like this:

<?xml version="1.0" encoding="utf-8"?>
<wiju>
	<ad>
        <id><![CDATA[...]]></id>
        <url><![CDATA[...]]></url>
        <title><![CDATA[...]]></title>
        <content><![CDATA[...]]></content>
        
        <price><![CDATA[...]]></price>
        
        <date><![CDATA[...]]></date>
        <time><![CDATA[...]]></time>
        
        <city><![CDATA[...]]></city>
        <region><![CDATA[...]]></region>
        <postcode><![CDATA[...]]></postcode>
        
        <year unit="meters"><![CDATA[...]]></year>
        <kilometers><![CDATA[...]]></kilometers>
        <doors><![CDATA[...]]></doors>
        
        <pictures>
         <picture>
          <picture_url><![CDATA[...]]></picture_url>
         </picture>
         <picture>
          <picture_url><![CDATA[...]]></picture_url>
         </picture>
        </pictures>
	</ad>
	<ad>
        ....
	</ad>
	<ad>
        ....
	</ad>
	...
</wiju>
  

Sample XML Feed

<?xml version="1.0" encoding="utf-8"?>
<wiju>
  <ad>
    <id><![CDATA[16677402]]></id>
    <url><![CDATA[http://www.yourdomain.com/1978-jeep-grand-cherokee-in-lancaster]]></url>
    <title><![CDATA[1978 Jeep Grand Cherokee in Lancaster]]></title>
    <content><![CDATA[1987 Jeep Cherokee 4X4 298,000 mis on BODY newer inline 6 cyl motor Needs powered steering, back shocks and two front stabilizer bars... It is drivable...we have drove it from Lancaster to Columbus and back $1000.]]></content>
    <price><![CDATA[1000]]></price>
    <date><![CDATA[2012-01-30]]></date>
    <time><![CDATA[17:52]]></time>
        
    <city><![CDATA[Lancaster]]></city>
    <region><![CDATA[Pennsylvania]]></region>
    <postcode><![CDATA[17601]]></postcode>
    
    <pictures>
      <picture>
        <picture_url><![CDATA[http://www.yourdomain.com/imagen_1.jpg]]></picture_url>
      </picture>
      <picture>
        <picture_url><![CDATA[http://www.yourdomain.com/imagen_2.jpg]]></picture_url>
      </picture>
    </pictures>
    
  </ad>
</wiju>
    

Version of about: 30/07/2012