Twelve-month ranking

Get your top 10 locations, ranked on review count, average rating and response rate combined, best first. With no dates, the window is the last 13 complete months (from the start of the month 13 months ago to the end of last month). Dates are Y-m-d H:i:s; the time part is ignored.

Prerequisites: a bearer token. Optional: store_id, review_site_id, and a window (range_start, range_end, both Y-m-d H:i:s).

Authentication: Partner or Account token. Without store_id the figures cover every location the token can see; store_id must be inside your own account tree, otherwise 422.

Rate limit: 120 requests per minute, counted per user (the token’s user).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
Defaults to 3007

One location. Must exist and be inside your account tree. Leave it out to cover every location your token can see.

integer
Defaults to 44

Only this review site, e.g. 44 for Google. Must be an existing review site.

string
Defaults to 2026-01-01 00:00:00

Start of the window, Y-m-d H:i:s (this endpoint needs the time part; a bare Y-m-d returns 422). The time is ignored: the window starts at the beginning of that day. Default: the start of the month 13 months ago.

string
Defaults to 2026-09-30 23:59:59

End of the window, Y-m-d H:i:s. Must be on or after range_start. The time is ignored: the window ends at the end of that day. Default: the end of last month.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json