메인 콘텐츠로 건너뛰기
GET
curl

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

쿼리 매개변수

from
string<date-time>
필수

기간 시작(포함). Z 또는 숫자 오프셋이 붙은 RFC 3339.

to
string<date-time>
필수

기간 끝(제외). Z 또는 숫자 오프셋이 붙은 RFC 3339. from으로부터 최대 366일 이내.

sort
enum<string>
기본값:views

순위 기준 수치(높은 순). 값이 같으면 documentId 오름차순입니다.

사용 가능한 옵션:
views,
uniqueVisitors,
leads
limit
integer
기본값:10

반환할 문서 수. 기본값 10, 100을 넘으면 100으로 조정됩니다. 페이지 이동은 없습니다.

필수 범위: x >= 1

응답

해당 기간의 문서 순위(data가 빈 배열일 수 있음).

from
string<date-time>
필수

요청한 기간의 시작(UTC, 포함).

to
string<date-time>
필수

요청한 기간의 끝(UTC, 제외).

sort
enum<string>
필수

목록의 순위 기준(sort를 지정하지 않으면 기본값 views).

사용 가능한 옵션:
views,
uniqueVisitors,
leads
data
object[]
필수

높은 순서이며 같은 값은 documentId 오름차순입니다. 최대 limit개이며 다음 페이지는 없습니다.