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

Field
Dependency
Required
Type
Possible values
Description
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, Apartment for Sale
  • 602 = House, Apartment for Rent
  • 603 = Room for Rent, Shared
  • 604 = Housing swap
  • 605 = Vacation rental
  • 606 = Parking spot
  • 607 = Land
  • 608 = Office, Commercial space
  • 609 = Shop for Rent, Sale

  • 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
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
  • USD = $ (USA Dollar)
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.



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>