Publish

Publish/Get

This method shows a list of the publish channels, where the named real estate object is published.

https://rest.immobilienscout24.de/restapi/api/offer/v1.0/publish

 

Example 1: https://rest.immobilienscout24.de/restapi/api/offer/v1.0/publish?realestate=58850320 lists all publish channels, in which the real estate object with the immoscout object id 58850320 is published.


Example 2: https://rest.immobilienscout24.de/restapi/api/offer/v1.0/publish?publishchannel=10001&realestate=58850320 lists the mapping of the real estate object with the immoscout object id 58850320 to the publish channel with the ID=10001, as a list; if the real estate object is not mapped to this publish channel, then the list is empty.

 

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

A System Key and an authenticated user are required for this operation:

 

Please use a secure connection (https) for this operation.

 

Request

Path Parameters

  • none

Query Parameters

  • {realestate}: The immoscout object id of the real estate object.
  • {publishchannel}: The ID of a certain publish channel (optional).

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.

Status 200 OK

The requested operation was successful.

Header

  • none

Body

XML

 

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <common:publishObjectsxmlns:xlink="http://www.w3.org/1999/xlink" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0">

<publishObject id="58850320_183">

<realEstate title="testzettel" id="58850320"/>

<publishChannel title="(Börse) CDI1" id="183"/>

</publishObject>

<publishObject id="58850320_10001">

<realEstate title="testzettel" id="58850320"/>

<publishChannel title="Homepage" id="10001"/>

</publishObject>

</common:publishObjects>

 

 

 

JSON

 

 

{

"common.publishObjects":   {

"publishObject":[

{

"@id":"58850320_183",

"realEstate":{

"@title":"testzettel",

"@id":"58850320"

},

"publishChannel":{

"@title":"(Börse) CDI1",

"@id":"183"

}},  

{

"@id":"58850320_10001",

"realEstate":{

"@title":"testzettel",

"@id":"58850320"

},

"publishChannel":{

"@title":"Homepage",

"@id":"10001"

}

}

]

}

}