Get the brokerage summary
https://api.ruuster.com/v1/summaryThe brokerage's numbers by week or month. Each bucket carries weeklyEmail, the exact figures Ruuster's weekly analytics email showed for that week: use those as the headline numbers in anything you show the brokerage or its clients. The measured fields beside them (human opens, signed-in leads) use stricter definitions and are expected to be lower; that is not an error, so don't report it as a discrepancy.
- Authentication:
x-api-keyandx-emailheaders of an owner or admin - Rate limit: 120 requests per minute per key
Query parameters
| Name | Type | Default | Description |
|---|---|---|---|
from |
date | 56 days before to |
First day, YYYY-MM-DD, included |
to |
date | today | Day after the last day, YYYY-MM-DD, excluded |
granularity |
string | week |
week or month |
Which numbers to show
Each bucket has two kinds of figures, and they are meant to differ:
weeklyEmail: the headline. The figures exactly as Ruuster's weekly (or monthly) analytics email showed them for that period. Your team and clients already see these every week, so use them as the headline numbers in reports, decks and summaries.- Everything else in the bucket: the measured detail. Ruuster's own records, counted more strictly. Use these for breakdowns and trends, labeled for what they are (for example "human opens, excluding automatic opens by mail apps").
The two use different definitions, so the measured figures are lower. Present them as different measures, not as a mismatch:
| Measure | Weekly email (weeklyEmail) |
Measured (series) |
|---|---|---|
| Email open rate | emailOpenRate: every recorded open, including automatic opens by mail apps and repeat opens, as the email shows it (can exceed 100) |
emails.openRateHuman: opens that don't look automated, over emails delivered |
| Email click rate | emailClickRate, as the email shows it |
emails.clickRate: clicks over emails delivered |
| Active people | uniqueActiveUsers: everyone the email counts as active |
uniqueActiveLeads: signed-in leads only |
| Activity | totalClientActivities, totalPageViews |
clientActivities, pageViews.*: actions and listing views by signed-in leads and agents |
| Emails sent | searchAlertsSent |
emails.sent, emails.delivered |
weeklyEmail is null for a bucket the email didn't cover (the current week before it's sent, or a brokerage that doesn't receive the email).
Response
Each bucket in data.series:
| Field | Description |
|---|---|
weeklyEmail |
The weekly analytics email's figures for this bucket, or null: totalPageViews, totalClientActivities, uniqueActiveUsers, pageViewsPerUser, searchAlertsSent, emailOpenRate, emailClickRate, totalNumberNurturedClients. The headline numbers; see above |
pageViews.public |
Google Analytics page views on your hostnames (all pages) by visitors who weren't logged in |
pageViews.lead, pageViews.agent |
Listing-page views by signed-in leads and agents, from Ruuster's own records |
clientActivities |
Actions by leads on your sites |
uniqueActiveLeads |
Distinct leads active in the bucket |
pageViewsPerLead |
pageViews.lead ÷ uniqueActiveLeads |
contactAgentClicks, tourRequests, searches, favorites, leadsCreated |
Counts |
savedSearches.createdByClients, createdByAgents |
Saved searches created |
emails |
sent, delivered, openedHuman, openRateHuman, clicked, clickRate |
pageViews.public covers all pages while pageViews.lead and pageViews.agent cover listing pages only, so there's no combined total.
data.platformReported[] lists the same weekly-email figures as one row per email, keyed by weekOf (or monthOf), for callers that read them separately. emailOpenRate and emailClickRate are percentages exactly as the email shows them. It is empty if your brokerage doesn't receive the weekly analytics email.