Website logo

Get office listing statistics

Returns listing statistics for all current listings listed by the office, including a break up by day and suburb.

URL: https://api.trademe.co.nz/v1/Property/Office/ListingStatistics.{file_format}
HTTP Method: GET
Requires Authentication? Yes
Permission Required: MyTradeMeRead: Read your membership & listing data.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Query String parameters

days Integer (optional)

The number of days of statistical data to retrieve, ending yesterday. Defaults to 30. Minimum 1, Maximum 30
page Integer (optional)

The page number of the set of results to return, starting from 1. Defaults to 1.

Returns

<ListingStatisticsPagedCollection>

A paged collection of listing statistics

TotalCount Integer TotalCount
Page Integer Page
PageSize Integer PageSize
List Collection of <ListingStatistics> or null InnerList
ListingId Integer ListingId
WatcherCount Integer WatcherCount
EnquiryCount Integer EnquiryCount
IsSuperFeatured Boolean IsSuperFeatured
DailyStatistics Collection of <DailyListingStatistics> or null DailyStatistics
Day DateTime Day
NewViewCount Integer NewViewCount
NewImpressionsCount Integer NewImpressionsCount
PerSuburbWatchersStatistics Collection of <PerSuburbListingStatistics> or null PerSuburbWatchersStatistics
CurrentCount Integer CurrentCount
SuburbId Integer SuburbId
SuburbName String or null SuburbName
RegionId Integer RegionId
RegionName String or null RegionName
GSRegionId Integer GSRegionId
PerSuburbViewsStatistics Collection of <PerSuburbListingStatistics> or null PerSuburbViewsStatistics
(This type has already been defined)
ClickToCallCount Integer ClickToCallCount
MemberIds Collection of Integer or null MemberIds
GlobalPropertyNetworkStatistics <GlobalPropertyNetwork> or null GlobalPropertyNetworkStatistics
ReaUrl String or null ReaUrl
RealtorUrl String or null RealtorUrl
HousingUrl String or null HousingUrl
ProptigerUrl String or null ProptigerUrl
MakaanUrl String or null MakaanUrl
ThinkoflivingUrl String or null ThinkoflivingUrl
ImpressionsCount Integer ImpressionsCount
ImpressionsInPeriod Integer ImpressionsInPeriod
ImpressionsCountAvgPerDay Integer ImpressionsCountAvgPerDay
TotalPages Integer or null TotalPages

Example XML Response (switch to JSON) 

<ListingStatisticsPagedCollection xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <ListingStatistics>
      <ListingId>123</ListingId>
      <WatcherCount>123</WatcherCount>
      <EnquiryCount>123</EnquiryCount>
      <IsSuperFeatured>false</IsSuperFeatured>
      <DailyStatistics>
        <DailyListingStatistics>
          <Day>2018-01-01T00:00:00Z</Day>
          <NewViewCount>123</NewViewCount>
          <NewImpressionsCount>123</NewImpressionsCount>
        </DailyListingStatistics>
        <DailyListingStatistics>
          <Day>2018-01-01T00:00:00Z</Day>
          <NewViewCount>123</NewViewCount>
          <NewImpressionsCount>123</NewImpressionsCount>
        </DailyListingStatistics>
      </DailyStatistics>
      <PerSuburbWatchersStatistics>
        <PerSuburbListingStatistics>
          <CurrentCount>123</CurrentCount>
          <SuburbId>123</SuburbId>
          <SuburbName>ABC</SuburbName>
          <RegionId>123</RegionId>
          <RegionName>ABC</RegionName>
          <GSRegionId>123</GSRegionId>
        </PerSuburbListingStatistics>
        <PerSuburbListingStatistics>
          <CurrentCount>123</CurrentCount>
          <SuburbId>123</SuburbId>
          <SuburbName>ABC</SuburbName>
          <RegionId>123</RegionId>
          <RegionName>ABC</RegionName>
          <GSRegionId>123</GSRegionId>
        </PerSuburbListingStatistics>
      </PerSuburbWatchersStatistics>
      <PerSuburbViewsStatistics>
        <PerSuburbListingStatistics />
        <PerSuburbListingStatistics />
      </PerSuburbViewsStatistics>
      <ClickToCallCount>123</ClickToCallCount>
      <MemberIds>
        <int>123</int>
        <int>123</int>
      </MemberIds>
      <GlobalPropertyNetworkStatistics>
        <ReaUrl>ABC</ReaUrl>
        <RealtorUrl>ABC</RealtorUrl>
        <HousingUrl>ABC</HousingUrl>
        <ProptigerUrl>ABC</ProptigerUrl>
        <MakaanUrl>ABC</MakaanUrl>
        <ThinkoflivingUrl>ABC</ThinkoflivingUrl>
      </GlobalPropertyNetworkStatistics>
      <ImpressionsCount>123</ImpressionsCount>
      <ImpressionsInPeriod>123</ImpressionsInPeriod>
      <ImpressionsCountAvgPerDay>123</ImpressionsCountAvgPerDay>
    </ListingStatistics>
    <ListingStatistics>
      <ListingId>123</ListingId>
      <WatcherCount>123</WatcherCount>
      <EnquiryCount>123</EnquiryCount>
      <IsSuperFeatured>false</IsSuperFeatured>
      <DailyStatistics>
        <DailyListingStatistics>
          <Day>2018-01-01T00:00:00Z</Day>
          <NewViewCount>123</NewViewCount>
          <NewImpressionsCount>123</NewImpressionsCount>
        </DailyListingStatistics>
        <DailyListingStatistics>
          <Day>2018-01-01T00:00:00Z</Day>
          <NewViewCount>123</NewViewCount>
          <NewImpressionsCount>123</NewImpressionsCount>
        </DailyListingStatistics>
      </DailyStatistics>
      <PerSuburbWatchersStatistics>
        <PerSuburbListingStatistics>
          <CurrentCount>123</CurrentCount>
          <SuburbId>123</SuburbId>
          <SuburbName>ABC</SuburbName>
          <RegionId>123</RegionId>
          <RegionName>ABC</RegionName>
          <GSRegionId>123</GSRegionId>
        </PerSuburbListingStatistics>
        <PerSuburbListingStatistics>
          <CurrentCount>123</CurrentCount>
          <SuburbId>123</SuburbId>
          <SuburbName>ABC</SuburbName>
          <RegionId>123</RegionId>
          <RegionName>ABC</RegionName>
          <GSRegionId>123</GSRegionId>
        </PerSuburbListingStatistics>
      </PerSuburbWatchersStatistics>
      <PerSuburbViewsStatistics>
        <PerSuburbListingStatistics />
        <PerSuburbListingStatistics />
      </PerSuburbViewsStatistics>
      <ClickToCallCount>123</ClickToCallCount>
      <MemberIds>
        <int>123</int>
        <int>123</int>
      </MemberIds>
      <GlobalPropertyNetworkStatistics>
        <ReaUrl>ABC</ReaUrl>
        <RealtorUrl>ABC</RealtorUrl>
        <HousingUrl>ABC</HousingUrl>
        <ProptigerUrl>ABC</ProptigerUrl>
        <MakaanUrl>ABC</MakaanUrl>
        <ThinkoflivingUrl>ABC</ThinkoflivingUrl>
      </GlobalPropertyNetworkStatistics>
      <ImpressionsCount>123</ImpressionsCount>
      <ImpressionsInPeriod>123</ImpressionsInPeriod>
      <ImpressionsCountAvgPerDay>123</ImpressionsCountAvgPerDay>
    </ListingStatistics>
  </List>
  <TotalPages>123</TotalPages>
</ListingStatisticsPagedCollection>

Example JSON Response (switch to XML) 

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "ListingId": 123,
      "WatcherCount": 123,
      "EnquiryCount": 123,
      "IsSuperFeatured": false,
      "DailyStatistics": [
        {
          "Day": "\/Date(1514764800)\/",
          "NewViewCount": 123,
          "NewImpressionsCount": 123
        },
        {
          "Day": "\/Date(1514764800)\/",
          "NewViewCount": 123,
          "NewImpressionsCount": 123
        }
      ],
      "PerSuburbWatchersStatistics": [
        {
          "CurrentCount": 123,
          "SuburbId": 123,
          "SuburbName": "ABC",
          "RegionId": 123,
          "RegionName": "ABC",
          "GSRegionId": 123
        },
        {
          "CurrentCount": 123,
          "SuburbId": 123,
          "SuburbName": "ABC",
          "RegionId": 123,
          "RegionName": "ABC",
          "GSRegionId": 123
        }
      ],
      "PerSuburbViewsStatistics": [
        {
        },
        {
        }
      ],
      "ClickToCallCount": 123,
      "MemberIds": [
        123,
        123
      ],
      "GlobalPropertyNetworkStatistics": {
        "ReaUrl": "ABC",
        "RealtorUrl": "ABC",
        "HousingUrl": "ABC",
        "ProptigerUrl": "ABC",
        "MakaanUrl": "ABC",
        "ThinkoflivingUrl": "ABC"
      },
      "ImpressionsCount": 123,
      "ImpressionsInPeriod": 123,
      "ImpressionsCountAvgPerDay": 123
    },
    {
      "ListingId": 123,
      "WatcherCount": 123,
      "EnquiryCount": 123,
      "IsSuperFeatured": false,
      "DailyStatistics": [
        {
          "Day": "\/Date(1514764800)\/",
          "NewViewCount": 123,
          "NewImpressionsCount": 123
        },
        {
          "Day": "\/Date(1514764800)\/",
          "NewViewCount": 123,
          "NewImpressionsCount": 123
        }
      ],
      "PerSuburbWatchersStatistics": [
        {
          "CurrentCount": 123,
          "SuburbId": 123,
          "SuburbName": "ABC",
          "RegionId": 123,
          "RegionName": "ABC",
          "GSRegionId": 123
        },
        {
          "CurrentCount": 123,
          "SuburbId": 123,
          "SuburbName": "ABC",
          "RegionId": 123,
          "RegionName": "ABC",
          "GSRegionId": 123
        }
      ],
      "PerSuburbViewsStatistics": [
        {
        },
        {
        }
      ],
      "ClickToCallCount": 123,
      "MemberIds": [
        123,
        123
      ],
      "GlobalPropertyNetworkStatistics": {
        "ReaUrl": "ABC",
        "RealtorUrl": "ABC",
        "HousingUrl": "ABC",
        "ProptigerUrl": "ABC",
        "MakaanUrl": "ABC",
        "ThinkoflivingUrl": "ABC"
      },
      "ImpressionsCount": 123,
      "ImpressionsInPeriod": 123,
      "ImpressionsCountAvgPerDay": 123
    }
  ],
  "TotalPages": 123
}