Feed specifications

Would you post for free your website or business advertisements?

Now is easy with Clasf. You only need to create an XML file, upload it to an URL and send it to us.

Once we have checked that the XML matches the features listed below, we will post your ads.

You can send the XML feed URL at our email address contact_za@clasf.com

Classifieds specifications

  • Write a different title and description for each classified ad, since identical ads will be not validated.
  • At least 100 characters ads description.
  • The ads must be written in English.

Furthermore, it is important that the XML feed contains the contact data , and at least one email address.

Non-compliant ads will be not published. Moreover, in our Terms of Use webpage you can read our posting rules and which kind of content Clasf does not accept.

What benefits could you get?

  • Massive and faster posting of your ads.
  • Automatic integration, update and deletion ads.
  • You will get a personal profile where you will check all your classifieds.
  • You will take part in Clasf Online Shops.

Feed configuration

Format: The feed must be in XML format.

Encoding: The character encoding must be UTF-8.

Sending the feed: Ad Image URL. We will download the image directly from that URL. You can upload up to 20 images per ad. It must be enclosed on a < ! [ CDATA[ ]] > wrapper.

Field specifications

FieldTypeDescription
url(*)<![CDATA[ ]]>This field must contain de ad URL or any other unique ID. Required field.
title(*)<![CDATA[ ]]>Ad title. It must be enclosed in a < ! [ CDATA[ ]] > wrapper. Required field.
description(*)<![CDATA[ ]]>Ad description. It must be enclosed in a < ! [ CDATA[ ]] > wrapper. It has to be larger than 100 characters. The HTML code is not allowed, exception made for the <br> tag. Required field.
priceDecimal numberItem price in the country currency, no symbol.
email(*)<![CDATA[ ]]>Contact email. It will be used on the item page when a user clicks on the "Contact the advertiser" button. It must be enclosed in a < ! [ CDATA[ ]] > wrapper. Required field.
contactFree textAdditional contact information, for example, a phone number. This information will be shown when a user clicks on the “Contact the advertiser” button.
city<![CDATA[ ]]>City name where the ad is located (ie: Johannesburg). Leave blank for the whole country. See the list of cities.
province<![CDATA[ ]]>Province (or state/region) name where the ad is located (ie: Gauteng). This field is related to the City name field. See the list of cities.
category(*)<![CDATA[ ]]>Clasf category. See the list of categories.
picturesurl_img tag. You can include up to 5 url_img tags with their own urls.
url_img<![CDATA[ ]]>Image URL for the ad. We'll download the image from that URL. You can upload up to 5 images per ad. It must be enclosed on a < ! [ CDATA[ ]] > wrapper.
video<![CDATA[ ]]>Youtube Video. Ex:hjYL18Zhb7A. This ID has been extracted from the URL https://www.youtube.com/watch?v=hjYL18Zhb7A

(*) Mandatory field

Additional fields can be included in the description.

HTML codes are not allowed in any field except for the tag '<br> '

XML file sample

<?xml version='1.0' encoding='UTF-8'?> <ads> <ad> <url><![CDATA[ http://www.yourdomain.com/your-ad-url ]]></url> <title><![CDATA[2009 Ford Escort Motor - good condition - 50,000 miles]]></title> <description><![CDATA[Ford escort motor. An excellent description with a lot of details.]]></description> <price>1000.00</price> <email><![CDATA[ sales@yourdomain.com ]]></email> <contact><![CDATA[ 123 555 1234 sales@yourdomain.com]]></contact> <city><![CDATA[ your city ]]></city> <province><![CDATA[ your province ]]></province> <category><![CDATA[ Motors ]]></category> <pictures> <url_img><![CDATA[ http://www.yourdomain.com/image-1.png ]]></url_img> <url_img><![CDATA[ http://www.yourdomain.com/image-2.png ]]></url_img> <url_img><![CDATA[ http://www.yourdomain.com/image-3.png ]]></url_img> <url_img><![CDATA[ http://www.yourdomain.com/image-4.png ]]></url_img> ... </pictures> <video><![CDATA[hjYL18Zhb7A]]></video> </ad> </ads>

List of categories

  • Home and garden
  • Fashion
  • Education and books
  • Image and sound
  • Computing
  • Real Estate
  • Games
  • Motors
  • Sports and sailing
  • Services
  • Phones
  • Animals
  • Leisure

List of cities

  • Adelaide
  • Alberton
  • Alice
  • Aliwal North
  • Allanridge
  • Atlantis
  • Balfour
  • Ballitoville
  • Barberton
  • Barkly East
  • Barkly West
  • Beaufort West
  • Belfast
  • Benoni
  • Bergville
  • Bethal
  • Bethlehem
  • Bisho
  • Bizana
  • Bloemfontein
  • Bloemhof
  • Boksburg
  • Botshabelo
  • Brakpan
  • Brandfort
  • Bredasdorp
  • Breyten
  • Brits
  • Bronkhorstspruit
  • Bulfontein
  • Burgersdorp
  • Butterworth
  • Caledon
  • Calitzdorp
  • Calvinia
  • Camperdown
  • Cape Town
  • Carltonville
  • Carnarvon
  • Centurion
  • Ceres
  • Christiana
  • Citrusdal
  • Clocolan
  • Cofimvaba
  • Colesberg
  • Cradock
  • Creighton
  • Cullinan
  • Danielskuil
  • Dannhauser
  • De Aar
  • Delmas
  • Dendron
  • Deneysville
  • Dordrecht
  • Duiwelskloof
  • Dundee
  • Durban
  • East London
  • Ekangala
  • Ekuphumleni
  • Ekuvukeni
  • Elliot
  • Ellisras
  • Embalenhle
  • Emnambithi
  • Empangeni
  • Empuluzi
  • Engcobo
  • Epumalanga
  • Ermelo
  • Eshowe
  • Esikhawini
  • Ezibeleni
  • Flagstaff
  • Fochville
  • Fort Beaufort
  • Frankfort
  • GaRankuwa
  • Garies
  • George
  • Giyani
  • Glencoe
  • Grabouw
  • Graff Reinet
  • Grahamstown
  • Greytown
  • Griekwastad
  • Groblersdal
  • Groblershoop
  • Harding
  • Harrismith
  • Hartswater
  • Heidelberg Gauten
  • Heidelberg Wester
  • Heilbron
  • Hendrina
  • Hennenman
  • Hermanus
  • Hertzogville
  • Hluhluwe
  • Hoopstad
  • Howick
  • Idutywa
  • Impendle
  • Inyala
  • Ixopo
  • Jan Kempdorp
  • Jansenville
  • Jeffreys Bay
  • Johannesburg
  • Kareedouw
  • Kathu
  • Keimoes
  • Kempton Park
  • Kgotsong
  • Kimberley
  • Kirkwood
  • Klerksdorp
  • Knysna
  • Koffiefontein
  • Kokstad
  • Komatipoort
  • Komga
  • Koppies
  • Koster
  • Kriel
  • Kroonstad
  • Krugersdorp
  • Kruisfontein
  • Kuruman
  • Kutlwanong
  • Kwambonambi
  • KwaNgema
  • Lady Frere
  • Ladybrand
  • Laingsburg
  • Lebohang
  • Lebowakgomo
  • Letsopa
  • Libode
  • Lichtenburg
  • Llinge
  • Louis Trichardt
  • Lulekano
  • Lydenburg
  • Mabopane
  • Malmesbury
  • Mandeni
  • Mankweng
  • Marblehall
  • Margate
  • Marquard
  • Matatiele
  • Melmoth
  • Messina
  • Middelburg
  • Middlelburg
  • Midrand
  • Mier
  • Mmabatho
  • Mogwase
  • Molteno
  • Mondlo
  • Mooi River
  • Mooreesburg
  • Mosselbay
  • Mothibistad
  • Mount Fletcher
  • Mpophomeni
  • Mutale
  • Ncotshane
  • Nelspruit
  • Newcastle
  • Nigel
  • Nkandla
  • Nkowakowa
  • Nongoma
  • Nquthu
  • Ntabankulu
  • Nylstroom
  • Orkney
  • Oudtshoorn
  • Paarl
  • Pampierstad
  • Parys
  • Paulpietersburg
  • Phalaborwa
  • Phola
  • Phuthaditjhaba
  • Piet Retief
  • Pietermaritzburg
  • Pietersburg
  • Plettenbergbay
  • poffadder
  • Pomfret
  • Port Alfred
  • Port Elizabeth
  • Port Nolloth
  • Port Saint Jones
  • Port Shepstone
  • Postmasburg
  • Potchefstroom
  • Potgietersrus
  • Pretoria
  • Prieska
  • Prince Albert
  • Queenstown
  • Qumbu
  • Randfontein
  • Randvaal
  • Reddersburg
  • Reitz
  • Reivelo
  • Richards Bay
  • Richmond
  • Ritchie
  • Robertson
  • Rustenburg
  • Saldanha
  • Sasolburg
  • Schweizer Reneke
  • Scottsburgh
  • Secunda
  • Senekal
  • Siyabuswa
  • Soekmekaar
  • Somerset East
  • Somerset West
  • Soweto
  • Springbok
  • Springs
  • Standerton
  • Stanger
  • Stellenbosch
  • Stilfontein
  • Strydenburg
  • Stutterheim
  • Sundumbili
  • Sutherland
  • Swellendam
  • Tarkastad
  • Temba
  • Tembisa
  • Thaba Nchu
  • Thabazimbi
  • Theunissen
  • Thohoyandou
  • Thulamahashe
  • Tzaneen
  • Uitenhage
  • Ulundi
  • Umkomaas
  • Umtata
  • Umzimkulu
  • Umzimvubu
  • Underberg
  • Upington
  • Utrecht
  • Vanderbijlpark
  • Vanderkloof
  • Velddrif
  • Ventersburg
  • Ventersdorp
  • Vereeniging
  • Victoria West
  • Viljoenskroon
  • Villiers
  • Virginia
  • Volksrust
  • Vrede
  • Vredefort
  • Vredenburg
  • Vredendal
  • Vryburg
  • Vryheid
  • Warmbad
  • Warrenton
  • Wartburg
  • Webmbezi
  • Welkom
  • Wepener
  • Wesselsbron
  • Westonaria
  • Whittlesea
  • Willowmore
  • Winburg
  • Witbank
  • Witrivier
  • Wolmaranstad
  • Worcester
  • Zastron
  • Zeerust

Free Classified ads - buy and sell cheap items in South Africa | CLASF - copyright ©2020 www.clasf.co.za.