Skip to content

ScoutReport

Update on the numbers in the reports

We should inform you, that from the 4th of August, we will report new numbers for you in the report functions. The data for fields:
* matchesResultList
* displaysResultList
* exposeHits
will show/equal zero for dates before 22.07.2020 and will show/equal the data as in database for dates after 22.07.2020.

Examples are at the bottom of the page.

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 than 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>

Response at 4th of August

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dailyReports objectNumber="999998">
<reportDailyData>
    <date>2020-07-10</date>
    <matchesResultList>0</matchesResultList> --> 0 as the date is before  "2020-07-22"
    <displaysResultList>0</displaysResultList> --> 0 as the date is before  "2020-07-22"
    <exposeHits>0</exposeHits> --> 0 as the date is before  "2020-07-22"
    <onShortList>0</onShortList>
    <clicksHomepage>0</clicksHomepage>
    <emailContacts>0</emailContacts>
    <clicksSendUrl>0</clicksSendUrl>
    <clickFocusPlacement>0</clickFocusPlacement>
    <showMiniExposeFocusPlacement>0</showMiniExposeFocusPlacement>
    <displayFocusPlacement>0</displayFocusPlacement>
</reportDailyData>
...................................................
<reportDailyData>
    <date>2020-07-22</date>
    <matchesResultList>0</matchesResultList> --> show data as in the database as the date is after  "2020-07-22"
    <displaysResultList>0</displaysResultList>  --> show data as in the database as the date is after  "2020-07-22"
    <exposeHits>0</exposeHits>  --> show data as in the database as the date is after  "2020-07-22"
    <onShortList>0</onShortList>
    <clicksHomepage>0</clicksHomepage>
    <emailContacts>0</emailContacts>
    <clicksSendUrl>0</clicksSendUrl>
    <clickFocusPlacement>0</clickFocusPlacement>
    <showMiniExposeFocusPlacement>0</showMiniExposeFocusPlacement>
    <displayFocusPlacement>0</displayFocusPlacement>
</reportDailyData>
...................................................
<reportDailyData>
    <date>2020-07-31</date>
    <matchesResultList>0</matchesResultList> --> show data as in the database as the date is after  "2020-07-22"
    <displaysResultList>0</displaysResultList>  --> show data as in the database as the date is after  "2020-07-22"
    <exposeHits>0</exposeHits>  --> show data as in the database as the date is after  "2020-07-22"
    <onShortList>0</onShortList>
    <clicksHomepage>0</clicksHomepage>
    <emailContacts>0</emailContacts>
    <clicksSendUrl>0</clicksSendUrl>
    <clickFocusPlacement>0</clickFocusPlacement>
    <showMiniExposeFocusPlacement>0</showMiniExposeFocusPlacement>
    <displayFocusPlacement>0</displayFocusPlacement>
</reportDailyData>
</dailyReports>