Submit Your Sitemap To Us.
If you are a car dealer and own a website contains cars Ads, you can submit your Sitemap to us that you don't need post Ads manually. Through the Sitemap , our system will crawl the Ads from your site daily. Also, we can update the Price or Status or other details when your Ads were changed in Sitemap.
  • Contact Us : service@icarslist.com , Send your website url and summary about your Company or business.
  • After we approved your request and submit the Sitemap to us , our system will crawl the Ads from your site.
    Our Sitemap Format
  • There were 2 types URL in our Sitemap:
    • List URL , a Sitemap list all Adverts' URL , you only should submit this URL to us.
    • Detail URL , the details of each advert.
  • Content of URL should be JSON format.
  • View our Sitemap demo URL: Sitemap Demo
  • After you made the Sitemap , click to submit
  • Validate Sitemap Tool.
  • Sitemap List Url Format
    The List URL means how many Ads we should crawl on your site. You should list all Detail URLs on this URL.
  • For example , we create a URL http://www.yourdomain.com/sitemap/list.html and response a JSON content as below:
  • Only this URL you should submit to us.
  • JSON Key Descriptions:
    Name Type Required Description
    errorCode Int Required Set to 0 means no errors , other Int value means error
    message String Optional If some errors occurred, you can set an error message to this value. When we got the error , the crawling would be stopped.
    data Object Required An array contains all Detail URLs , maximum elements is 30,000.
  • The Detail URLs must begin with http:// or https://
  • If your adverts more than 30,000 , you can set the pagination information with data.pagination , tell us how to get more adverts.
  • Each URL is a Detail URL , see the JSON format on the below.
  • data.pagination Object Optional To describe how many pages we should crawl.
    data.pagination.total Int Optional The total number of pagination.
    data.pagination.current Int Optional The page number of current List URL. It must start from 1.
  • When this value is greater than or equal to data.total , we will stop crawling.
  • data.pagination.nextPage String Optional The URL of next page we will crawl.
  • When current page is the last page, this value can set as '' (empty string)
  • When set to '' (empty string) , we will stop crawling.
  • Sitemap Detail URL Format
    A Detail URL contains all details of a vehicle.
  • For example , we create a URL http://www.yourdomain.com/url-to-car-detail.html?id=1 to response a JSON content as below:
  • JSON Key Descriptions:
    Name Type Required Description
    errorCode Int Required Set to 0 means no errors , other Int value means error
    message String Optional If some errors occurred, you can set an error message to this value.
    data Object Required The data Object describe the details of this vehicle
    data.id String Required A unique ID of this advert on your site.
  • We update each Advert's Price,Mileage,Status or other details via this ID. You should promise each Advert has its own unique ID.
  • Such as : 1234 , ba15c
  • data.condition String Required The condition of this vehicle.
  • Only can set as : Used , New
  • data.vehicleType String Required The type of this vehicle.
  • Only can set as : Car , Bike
  • data.postTime UTC Time Required The time of first post. The time should be UTC Time format.
  • Such as 2023-10-12T09:07:29Z
  • data.lastModify UTC Time Required The time of last modified. The time should be UTC Time format.
  • Such as 2023-10-12T09:07:29Z
  • When we found this value has been changed , we'll try to update this advert in our database.
  • data.make String Required The brand of this vehicle.
  • Only accept English words.
  • Such as Audi , BMW, Mercedes Benz , Aston Martin , Land Rover , Rolls Royce
  • We DO NOT allow '-' in a brand name , use a ' ' (space) instead of.
  • data.model String Required The Model of this vehicle.
  • Only accept English words.
  • Such as A6 , Camry, Jazz , 5 Series
  • data.subModel String Optional The Sub-Model of this vehicle.
  • This only provided when the current brand has series models , like BWM , Mercedes Benz.
  • Value such as : 525i , when the brand is BWM and model is 5 Series
  • Value such as : C230 , when the brand is Mercedes Benz and model is C-Class
  • Please Don't worry about the Models' values, our system can fix the problems when your model is not match ours.
    data.modelDetails String Optional More descriptions on model.
  • Accept descriptions from any language
  • Such as : Long Range , M Sport, 美版
  • data.price Number Required The Price of this vehicle.
  • Only accept number type
  • data.transmission String Required The transmission of this vehicle.
  • Only can set as : Automatic , Manual , Other
  • data.mileage Number Required The mileage of this vehicle. Unit: Km.
  • Only accept number type
  • data.exteriorColor String Required The exterior color of this vehicle.
  • Accept any color words from any language
  • Such as : Blue , White , 藍色 , Màu đen , สีน้ำเงิน
  • data.engine Number Required The Engine Capacity of this vehicle. Unit: cc.
  • Only accept number type
  • data.fuelType String Required The Fuel Type of this vehicle.
  • Only can set as : Petrol , Diesel , Electric , Hybrid , Other
  • data.status String Required The status of this advert. You can change this value for displaying or not on our site.
  • Only can set as : Active , Sold , Pending , Removed
  • Active : This advert will display on our site and status is On Sale.
  • Sold,Pending,Removed : This advert will NOT display on our site.
  • Removed : We will delete this advert in 90 days.
  • You also can manage the adverts on your user panel.
    data.description String Required The descriptions of this advert.
  • We DO NOT allow HTML codes in this value.
  • data.photos Array Required The photos of this vehicle.
  • Each element is the photo URL and should start with http:// or https://
  • data.coverPhoto String Optional The Cover photo of this vehicle , it will display on search results page or other pages.
  • If not set , we will use the first element of data.photos
  • If set , it should start with http:// or https://
  • data.interiorColor String Optional The interior color of this vehicle
  • Accept any color words from any language
  • The setting is same as data.exteriorColor
  • data.sellerName String Optional The contact name or seller name of this advert.
  • If not set , we'll use your account's seller name.
  • data.phone String Optional The contact phone of this advert.
  • If not set , we'll use your account's phone.
  • data.whatsApp String Optional The whatsApp account of this advert.
  • If not set , we'll use your account's whatsApp.
  • data.location String Optional The location of this advert.
  • If not set , we'll use your account's location.