{"id":339,"date":"2023-12-04T05:17:44","date_gmt":"2023-12-04T05:17:44","guid":{"rendered":"https:\/\/olxdoc.wpenginepowered.com\/?p=339"},"modified":"2024-08-19T08:03:36","modified_gmt":"2024-08-19T08:03:36","slug":"create-new-advert-2","status":"publish","type":"post","link":"https:\/\/doc.olxgroup.com\/api\/?p=339","title":{"rendered":"Create new advert"},"content":{"rendered":"\r\n

This section is restricted for partners use. If You accessing API with “password” grant type – go to\u00a0Account section.<\/p>\r\n

POST<\/strong>: https:\/\/www.autovit.ro\/api\/open\/adverts<\/a><\/p>\r\n

Permission: \u00a0advertsWrite<\/em><\/strong><\/p>\r\n

Header<\/h2>\r\n\r\n\r\n\r\n\r\n\r\n
Field<\/th>\r\nType<\/th>\r\nDescription<\/th>\r\n<\/tr>\r\n<\/thead>\r\n
User-Agent<\/td>\r\nstring<\/td>\r\nAccount email.<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n

Query Param<\/b><\/h2>\r\n\r\n\r\n\r\n\r\n
Field<\/b><\/td>\r\nType<\/b><\/td>\r\nDescription<\/b><\/td>\r\n<\/tr>\r\n
v optional<\/b><\/td>\r\nNumber<\/td>\r\nOptional parameter to specify which version to use (2 – for new version; anything else for OLD version)<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n

 <\/p>\r\n

Request Body<\/b><\/h2>\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n
Field<\/b><\/td>\r\nType<\/b><\/td>\r\nDescription<\/b><\/td>\r\n<\/tr>\r\n
coordinates<\/td>\r\nObject<\/td>\r\nLocation for map coordinates<\/td>\r\n<\/tr>\r\n
title<\/td>\r\nString<\/td>\r\nTitle<\/td>\r\n<\/tr>\r\n
description<\/td>\r\nString<\/td>\r\nDescription<\/td>\r\n<\/tr>\r\n
category_id<\/td>\r\nNumber<\/td>\r\nCategory id , see: Category<\/a><\/td>\r\n<\/tr>\r\n
region_id<\/td>\r\nNumber<\/td>\r\nRegion id , see: Regions<\/a><\/td>\r\n<\/tr>\r\n
city_id<\/td>\r\nNumber<\/td>\r\nCity id , see: Cities<\/a><\/td>\r\n<\/tr>\r\n
new_used<\/td>\r\nString<\/td>\r\nAllowed values: new, used<\/td>\r\n<\/tr>\r\n
advertiser_type<\/td>\r\nString<\/td>\r\nAllowed values: private, business<\/td>\r\n<\/tr>\r\n
email<\/td>\r\nString<\/td>\r\nRequired for partners. Email address of the offer owner<\/td>\r\n<\/tr>\r\n
partner_offer_url<\/td>\r\nString<\/td>\r\nRequired for partners. Offer url in client service<\/td>\r\n<\/tr>\r\n
external_id<\/td>\r\nString<\/td>\r\nRequired for partners. Offer id in client database database<\/td>\r\n<\/tr>\r\n
image_collection_id<\/td>\r\nString<\/td>\r\nId of images collection, see: Images<\/a><\/td>\r\n<\/tr>\r\n
district_id<\/td>\r\nNumber<\/td>\r\nDistrict id , see: Districts<\/a><\/td>\r\n<\/tr>\r\n
\u00a0 latitude<\/td>\r\nNumber<\/td>\r\nLatitude<\/td>\r\n<\/tr>\r\n
\u00a0 longitude<\/td>\r\nNumber<\/td>\r\nLongitude<\/td>\r\n<\/tr>\r\n
\u00a0 radius<\/td>\r\nNumber<\/td>\r\nRadius<\/td>\r\n<\/tr>\r\n
\u00a0 zoom_level<\/td>\r\nNumber<\/td>\r\nZoom level<\/td>\r\n<\/tr>\r\n
contact<\/td>\r\nObject<\/td>\r\nContact object<\/td>\r\n<\/tr>\r\n
\u00a0 phones<\/td>\r\nArray<\/td>\r\nThe list of phones to contact<\/td>\r\n<\/tr>\r\n
\u00a0 person<\/td>\r\nObject<\/td>\r\nThe name of the person to contact<\/td>\r\n<\/tr>\r\n
params<\/td>\r\nObject<\/td>\r\nDetailed advert parameters, see Category<\/a> to find what parameters are available for specific category<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n

 <\/p>\r\n

Example request:<\/strong>POST \/adverts HTTP\/1.1\r\nUser-Agent: $USER_EMAIL\r\nContent-Type: application\/json\r\nAuthorization: Bearer $ACCESS_TOKEN\r\n{\r\n \"title\": \"Advert title\",\r\n \"description\": \"Lorem ipsum dolor sit amet, consectetur adipiscing elit.\",\r\n \"category_id\": 29,\r\n \"region_id\": 1,\r\n \"city_id\": 1,\r\n \"district_id\": 1,\r\n \"coordinates\":\r\n {\r\n \"latitude\": 52.39255,\r\n \"longitude\": 16.86718\r\n },\r\n \"contact\":\r\n {\r\n \"person\": \"John Doe\"\r\n },\r\n \"params\":\r\n {\r\n \"vin\": \"11111111111111111\",\r\n \"year\": 2018,\r\n \"make\": \"ford\",\r\n \"model\": \"focus\",\r\n \"fuel_type\": \"petrol\",\r\n \"engine_power\": \"86\",\r\n \"engine_capacity\": \"1596\",\r\n \"door_count\": 4,\r\n \"gearbox\": \"manual\",\r\n \"generation\": \"gen-mk4-2018\",\r\n \"version\": \"ver-1-6-gold-x\",\r\n \"mileage\": 199000,\r\n \"body_type\": \"sedan\",\r\n \"color\": \"white\",\r\n \"price\":\r\n {\r\n \"0\": \"price\",\r\n \"1\": 2000,\r\n \"currency\": \"PLN\",\r\n \"gross_net\": \"gross\"\r\n },\r\n \"video\": \"https:\/\/www.youtube.com\/watch?v=code\"\r\n }\r\n \"image_collection_id\": 821165355,\r\n \"external_id\": \"126\",\r\n \"partner_offer_url\": \"http:\/\/partner-domain\/partner-offer-url\",\r\n \"advertiser_type\": \"private\",\r\n \"new_used\" : \"used\"\r\n}<\/code>