Skip to content

ScoutReport

Retrieve statistics of a specific object or list of objects in a specific timeframe of maximal 180 days.

GET /offer/v1.0/user/{username or me}/realestate/{realestate-id}/dailyreport?dateFrom=2019-01-01&dateTo=2019-01-02

Supported media types:
XML

Notes:

  • cannot provide data for more then 180 days
  • if no data entered then it will return data for today
  • if entered either "dateFrom" or "dateTo" then the method will provide the data for the written day

Request

Path Parameters

PARAMETER DESCRIPTION
Username the username which the user uses for logging in to www.immobilienscout24
me "me" can be used instead of the username, when the user is logged in by 3-legged oauth
realestate id the unique scout object ID, which is being created by POST REALESTATE automatically

Query parameters

PARAMETER VALUE
dateFrom 2019-09-01
dateTo 2019-09-31

Response

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dailyReports objectNumber="999998">
<reportDailyData>
  <date>2019-01-01</date>
  <matchesResultList>0</matchesResultList> <displaysResultList>0</displaysResultList>
  <exposeHits>0</exposeHits>
  <onShortList>0</onShortList>
  <clicksHomepage>0</clicksHomepage>
  <emailContacts>0</emailContacts>
  <clicksSendUrl>0</clicksSendUrl> <clickFocusPlacement>0</clickFocusPlacement> <showMiniExposeFocusPlacement>0</showMiniExposeFocusPlacement> <displayFocusPlacement>0</displayFocusPlacement>
</reportDailyData>
...................................................
<reportDailyData>
  <date>2019-01-31</date>
  <matchesResultList>0</matchesResultList> <displaysResultList>0</displaysResultList>
  <exposeHits>0</exposeHits>
  <onShortList>0</onShortList>
  <clicksHomepage>0</clicksHomepage>
  <emailContacts>0</emailContacts>
  <clicksSendUrl>0</clicksSendUrl> <clickFocusPlacement>0</clickFocusPlacement> <showMiniExposeFocusPlacement>0</showMiniExposeFocusPlacement> <displayFocusPlacement>0</displayFocusPlacement>
</reportDailyData> </dailyReports>