XML upload specifications
If you would like to publish large quantities of items on Adoist, the best way to do so is by sending us an XML data feed. Below we explain the steps you need to take to make sure the feed meets our specifications.
Encoding We accept only UTF-8 encoding.
Feed type The feed must contain every ad you want to be live on Adoist. The ads that are in the feed will be posted to Adoist. Any ads that are no longer in the feed will be deleted from Adoist. We require a static URL for this option (a URL that never changes).
Update frequency The frequency that we update your feed depends on your settings. You can choose the number of days between updates.
General fields
id
Yes
<![CDATA[Text]]>
This field must contain the partner unique id for that specific ad.
title
Yes
<![CDATA[Text]]>
Item title.
description
Yes
<![CDATA[Text]]>
Item description.
country
Yes
Adoist Code
US = United States
Country where the ad is located.
region
country
Yes
<![CDATA[Text]]>
Alaska Alabama Arkansas Arizona California Colorado Connecticut District of Columbia Delaware Florida Georgia Hawaii Iowa Idaho Illinois Indiana Kansas Kentucky Louisiana Massachusetts Maryland Maine Michigan Minnesota Missouri Mississippi Montana North Carolina North Dakota Nebraska New Hampshire New Jersey New Mexico Nevada New York Ohio Oklahoma Oregon Pennsylvania Rhode Island South Carolina South Dakota Tennessee Texas Utah Virginia Vermont Washington Wisconsin West Virginia Wyoming more regions...
State/region where the ad is located.
city
region
Yes
<![CDATA[Text]]>
City name where the ad is located. (ie: New York)
address
Optional
<![CDATA[Text]]>
If available, address where the ad is located.
category
Yes
Adoist Code
Vehicle 501 = Car 502 = Car part 503 = Motorcycle 504 = Boat, Ship 505 = RV, Camper, Caravan 506 = Truck, Commercial vehicle 599 = Other vehicles Real Estate 601 = House 6011 = Family house 6012 = Semi-detached house 6013 = Row house 6014 = Part of a house 6015 = Castle 602 = Condo 6021 = Brick condo 6022 = Panel condo 6023 = Sliding shuttered condo 603 = Room for Rent, Shared 604 = Housing swap 605 = Holiday house 606 = Parking spot 6061 = Detached garage 6062 = Underground garage space 6063 = parking space 607 = Land 6071 = Residential plot 6072 = Holiday plot 6073 = Periphery plot 6074 = Industrial plot 6079 = Other plot 608 = Office 609 = Business premises 610 = Hospitality 6101 = Hotel, Pension 6102 = Restaurant, Inn 6109 = Other hospitality unit 611 = Warehouse 612 = Industrial 6121 = Workroom 6122 = Place of business 6129 = Other industrial real estate 613 = Agricultural 6131 = Farmstead 6132 = Fieldland, Arable land 6133 = Forest 6134 = Cellar, Press house 6139 = Other agricultural real estate 614 = Development area 615 = Institution 6151 = Healthcare institution 6152 = School 6153 = Museum 6154 = Kindergarten Baby, Mammy 1001 = Child car seat 1002 = Baby care, Safety 1003 = Baby furniture, Room decor 1004 = Baby carriage, Baby carrier 1005 = Baby clothing 1006 = Baby toy 1007 = Maternity dress Community 301 = Carpool 302 = Community Activities 303 = Events 304 = Musicians, Artists, Bands 305 = Volunteers 306 = Lost and Found For Sale 101 = Animal, Pet 102 = Art, Collectibles 103 = Book, Magazine 104 = Business, Industrial 119 = Computer, Hardware 120 = Cell phone, Mobile accessories 106 = Music, CD, Records 107 = Movie, DVD 105 = Cameras, Camera accessories 108 = Electronics 109 = Garage Sale 118 = Clothing 110 = Health, Beauty 111 = Home, Furniture, Garden supplies 112 = Jewelry, Watches 113 = Musical instruments 114 = Sporting Goods, Bicycle 115 = Ticket 116 = Toy, Game, Hobby 117 = Video game, Console 199 = Others for sale Services 201 = Babysitter, Nanny, Elderly care 202 = Casting, Auditions 203 = Computer 204 = Event services 205 = Health, Beauty, Fitness 206 = Horoscopes, Tarot 207 = Household, Domestic help 208 = Moving, Storage 209 = Repair 210 = Writing, Editing, Translating 211 = Construction, renovation 212 = Education 213 = Finance, Legal services 214 = Advertisement, Media 215 = Hospitality, Shopping 216 = Sale 217 = Government, Institutions 218 = Travel 219 = Automotive 220 = Home services 299 = Other services Job 701 = Accounting job, Finance job 702 = Advertising job, Public relations job 703 = Ars job, Entertainment job, Publishing job 704 = Clerical job, Administrative job 705 = Customer service job 706 = Education job, training job 707 = Engineering job, Architecture job 708 = Healthcare job 709 = Hotel job, Travel job 710 = Human resource job 711 = Internet job 712 = Legal job 713 = Manual labor job 714 = Manufacturing job, Operations job 715 = Marketing job 716 = Non-profit job, Volunteer job 717 = Real estate job 718 = Restaurant job, Food service job 719 = Retail job 720 = Sales job 721 = Technology job 722 = Casual, seasonal job 723 = Banking, insurance job 724 = Shipping, logistics job 725 = Student job 799 = Other jobs Classes 401 = Computer, Multimedia classes 402 = Language classes 403 = Music, Theatre, Dance classes 404 = Tutoring, Private lessons 499 = Other classes Blog
Category ID.
name
Optional
<![CDATA[Text]]>
Contact name. It will be displayed on the item page.
email
Yes
<![CDATA[Text]]>
Contact email. It will be used on the item page when a user clicks on the "Reply to this ad" link.
phone
Optional
<![CDATA[Text]]>
Contact phone. It will be displayed on the item page.
price
Optional
Decimal
Item price in the country currency, without symbol. (For example: 154500)
currency
country
Optional
Adoist Code
Item price currency.
image
Optional
<![CDATA[Text]]>
Image url for the ad. We'll download the image from that url.
image
Optional
<![CDATA[Text]]>
Second image url for the ad.
image
Optional
<![CDATA[Text]]>
You may send up to 10 images. The first image will be the main.
Category specific fields (optionals) Our users use many other parameters to filter their searches when searching for ads. Some categories have special fields. By including them in your feed, your ads will be found more often and you will receive more replies.
Choose category and subcategory to see special fields.
Choose category Vehicle Real Estate Baby, Mammy Community For Sale Services Job Classes Blog
Choose subcategory
Sample XML
<?xml version="1.0" encoding="UTF-8"?>
<ads>
<ad>
<id><![CDATA[1]]></id>
<title><![CDATA[Audi A4 3.0 Sedan, Auto, 64K Miles, 2002]]></title>
<description><![CDATA[Long description]]></description>
<country>HU</country>
<region><![CDATA[Budapest]]></region>
<city><![CDATA[Budapest XX. kerület]]></city>
<address><![CDATA[]]></address>
<category>501</category>
<name><![CDATA[John Sample]]></name>
<email><![CDATA[example@yourdomain.com]]></email>
<phone><![CDATA[+36-99-9991111]]></phone>
<price>2200000</price>
<currency>HUF</currency>
<carbrand>audi</carbrand>
<carmodel>a4</carmodel>
<cartype>4-door</cartype>
<condition>used</condition>
<year>2002</year>
<carmileage>64000</carmileage>
<posttype>offer</posttype>
<sellertype>professionals</sellertype>
<image><![CDATA[http://www.yourdomain.com/image1.jpg]]></image>
<image><![CDATA[http://www.yourdomain.com/image2.jpg]]></image>
<image><![CDATA[http://www.yourdomain.com/image3.jpg]]></image>
<image><![CDATA[http://www.yourdomain.com/image4.jpg]]></image>
<image><![CDATA[http://www.yourdomain.com/image5.jpg]]></image>
</ad>
</ads>