Website logo

Get property office live listing statistics

Retrieve a list of a property listings for office user, with some basic statistics for This endpoint is available for all Trademe partner API accounts however is rate limited to 100 calls per hour per consumer

URL: https://api.trademe.co.nz/v1/Property/Office/{officeMemberId}/LiveListingStatistics.{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

officeMemberId Integer (required)
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 statistics to retrieve, ending yesterday. Defaults to 30. Minimum 1, maximum 30

Returns

<LivePropertyListingStatistics>

LivePropertyListingStatistics

LiveListingStatistics Collection of <ListingStatistics> or null LiveListingStatistics
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
OfficeDailyStatistics Collection of <OfficeDailyListingStatistics> or null OfficeDailyStatistics
Day DateTime Day
ListingCount Integer ListingCount
NewViewCount Integer NewViewCount
NewImpressionCount Integer NewImpressionCount

Example XML Response (switch to JSON) 

<LivePropertyListingStatistics xmlns="http://api.trademe.co.nz/v1">
  <LiveListingStatistics>
    <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>
  </LiveListingStatistics>
  <OfficeDailyStatistics>
    <OfficeDailyListingStatistics>
      <Day>2018-01-01T00:00:00Z</Day>
      <ListingCount>123</ListingCount>
      <NewViewCount>123</NewViewCount>
      <NewImpressionCount>123</NewImpressionCount>
    </OfficeDailyListingStatistics>
    <OfficeDailyListingStatistics>
      <Day>2018-01-01T00:00:00Z</Day>
      <ListingCount>123</ListingCount>
      <NewViewCount>123</NewViewCount>
      <NewImpressionCount>123</NewImpressionCount>
    </OfficeDailyListingStatistics>
  </OfficeDailyStatistics>
</LivePropertyListingStatistics>

Example JSON Response (switch to XML) 

{
  "LiveListingStatistics": [
    {
      "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
    }
  ],
  "OfficeDailyStatistics": [
    {
      "Day": "\/Date(1514764800)\/",
      "ListingCount": 123,
      "NewViewCount": 123,
      "NewImpressionCount": 123
    },
    {
      "Day": "\/Date(1514764800)\/",
      "ListingCount": 123,
      "NewViewCount": 123,
      "NewImpressionCount": 123
    }
  ]
}