Body
-
Optional custom id that can later be used instead of normal id in
insert
,update
,delete
etc. endpoints -
This field controls the publicity status of the ad. Ads with status
open
andreserved
will be publicly visible. Others will be hidden. If the advertised property was sold, use statussold
. If the advertised property failed to sell and should be hidden, use the statuslost
. If you don't have the information about whether the property was sold or failed to sell or you want to hide it for any other reason, use the statusinactive
. If not provided upon insertion, it will default toopen
.Values are
open
,reserved
,sold
,lost
, orinactive
. -
Values are
sell
,rent
,auction
, orshare
. -
Id of a company. It is either id that was provided in the response of the insert endpoint or it can be thirdPartyId, if it has been provided in the request body of the company insert endpoint.
-
Id of a company. It is either id that was provided in the response of the insert endpoint or it can be thirdPartyId, if it has been provided in the request body of the company insert endpoint.
-
Use total price for type
sell
and monthly rent for typerent
. -
Values are
czk
,usd
, oreur
. -
Most accurate location description of a location. Preferably exact address in the format common for the given country. If that isn't possible, provide us with the most accurate location description possible. (eg. '{street name}, {city}')
-
Accuracy of the provided location. If not provided upon insertion, will default to
exact
.- If accuracy is missing or is set to
exact
we will display the exact location that was provided. - If accuracy is set to other value we will try to find the closest entity of provided type, if we don't find it we will display the nearest non-exact entity we can find (eg. street)
Values are
exact
,street
,municipality_part
,municipality
,cadastral_area
, ornearest_non_exact_geo_entity
. - If accuracy is missing or is set to
-
Also known as 'advert_code' on other platforms.
-
Additional properties are NOT allowed.
curl \
--request POST 'http://apis.reas.cz/advertising/v1.0/ads/' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"thirdPartyId":"1000025","status":"open","type":"sell","advertiserId":"63d9007e66fc41b2cd1057c6","advertisingCompanyId":"63d9007e66fc41b2cd1057c6","price":42.0,"currency":"czk","priceNote":"string","location":"Jablonecká 415/4, Praha 9","locationAccuracy":"exact","description":"string","referenceId":"string","matterportUrl":"string","possibleMoveInDate":"2025-05-04T09:42:00Z","estimatedOtherCosts":42.0,"point":{"latitude":42.0,"longitude":42.0},"property":{"type":"flat","subType":"flat","floor":42.0,"ownership":"private","disposition":"1+kk","floorArea":42.0,"utilityArea":42.0,"constructionType":"brick","elevator":true,"floorsCount":42.0,"balcony":true,"balconyArea":42.0,"loggia":true,"loggiaArea":42.0,"cellar":true,"cellarArea":42.0,"terrace":true,"terraceArea":42.0,"parkingSpace":true,"parkingSpaceCount":42.0,"accessibility":true,"heatingKind":["solid_fuels"],"energyClass":"A","sauna":true,"fireplace":true}}'
{
"thirdPartyId": "1000025",
"status": "open",
"type": "sell",
"advertiserId": "63d9007e66fc41b2cd1057c6",
"advertisingCompanyId": "63d9007e66fc41b2cd1057c6",
"price": 42.0,
"currency": "czk",
"priceNote": "string",
"location": "Jablonecká 415/4, Praha 9",
"locationAccuracy": "exact",
"description": "string",
"referenceId": "string",
"matterportUrl": "string",
"possibleMoveInDate": "2025-05-04T09:42:00Z",
"estimatedOtherCosts": 42.0,
"point": {
"latitude": 42.0,
"longitude": 42.0
},
"property": {
"type": "flat",
"subType": "flat",
"floor": 42.0,
"ownership": "private",
"disposition": "1+kk",
"floorArea": 42.0,
"utilityArea": 42.0,
"constructionType": "brick",
"elevator": true,
"floorsCount": 42.0,
"balcony": true,
"balconyArea": 42.0,
"loggia": true,
"loggiaArea": 42.0,
"cellar": true,
"cellarArea": 42.0,
"terrace": true,
"terraceArea": 42.0,
"parkingSpace": true,
"parkingSpaceCount": 42.0,
"accessibility": true,
"heatingKind": [
"solid_fuels"
],
"energyClass": "A",
"sauna": true,
"fireplace": true
}
}
{
"success": true,
"data": {
"thirdPartyId": "1000025",
"status": "open",
"type": "sell",
"advertiserId": "63d9007e66fc41b2cd1057c6",
"advertisingCompanyId": "63d9007e66fc41b2cd1057c6",
"price": 42.0,
"currency": "czk",
"priceNote": "string",
"location": "Jablonecká 415/4, Praha 9",
"locationAccuracy": "exact",
"description": "string",
"referenceId": "string",
"matterportUrl": "string",
"possibleMoveInDate": "2025-05-04T09:42:00Z",
"estimatedOtherCosts": 42.0,
"point": {
"latitude": 42.0,
"longitude": 42.0
},
"property": {
"type": "flat",
"subType": "flat",
"floor": 42.0,
"ownership": "private",
"disposition": "1+kk",
"floorArea": 42.0,
"utilityArea": 42.0,
"constructionType": "brick",
"elevator": true,
"floorsCount": 42.0,
"balcony": true,
"balconyArea": 42.0,
"loggia": true,
"loggiaArea": 42.0,
"cellar": true,
"cellarArea": 42.0,
"terrace": true,
"terraceArea": 42.0,
"parkingSpace": true,
"parkingSpaceCount": 42.0,
"accessibility": true,
"heatingKind": [
"solid_fuels"
],
"energyClass": "A",
"sauna": true,
"fireplace": true
},
"id": "string",
"advertiserThirdPartyId": "string",
"advertisingCompanyThirdPartyId": "string",
"previewUrl": "string"
}
}