Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Query Parameters

from
string<date-time>
required

Start of the range, inclusive. RFC 3339 with Z or a numeric offset.

to
string<date-time>
required

End of the range, exclusive. RFC 3339 with Z or a numeric offset. At most 366 days after from.

sort
enum<string>
default:views

The metric to rank by, highest first. Ties are ordered by documentId ascending.

Available options:
views,
uniqueVisitors,
leads
limit
integer
default:10

How many documents to return. Default 10; values above 100 are clamped to 100. There is no paging.

Required range: x >= 1

Response

The ranked documents for the range (possibly an empty data array).

from
string<date-time>
required

Start of the range as requested, in UTC (inclusive).

to
string<date-time>
required

End of the range as requested, in UTC (exclusive).

sort
enum<string>
required

The metric the list is ranked by (the default views when sort was not given).

Available options:
views,
uniqueVisitors,
leads
data
object[]
required

Highest first, ties by documentId ascending. At most limit entries; no next page.