> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 페이지네이션

더 많은 캠페인 수를 지원하고 계정과 연결된 모든 엔티티를 효율적으로 조회하기 위해, Advertiser API는 이제 여러 GET 엔드포인트에서 페이지네이션을 지원합니다. 이 페이징 메커니즘은 사용하기 쉽고, [컬렉션을 탐색하기 위한 커서 사용](https://developer.x.com/en/docs/x-api/v1/pagination)에 설명된 REST API의 커서 기반 페이지네이션과 매우 유사합니다.

<div id="getting-started">
  ## 시작하기
</div>

지정된 GET 요청에 대해 이제 선택 사항인 `cursor` 및 `count` 쿼리 파라미터를 지원합니다. 응답에 엔티티가 `count`개보다 많이 포함된 경우, 이 엔드포인트들은 처음 `count`개의 엔티티와 함께 응답 JSON에 `next_cursor` 키를 반환합니다.

`GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50`

```json theme={null}
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
```

다음 응답 페이지를 가져오려면 쿼리 매개변수에 `cursor`를 추가합니다:

`GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50`

```json theme={null}
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}
```

<div id="going-deeper">
  ## 더 자세히 알아보기
</div>

대부분의 엔드포인트에서 `count`의 최대값은 **1,000**, 최소값은 **1**, 기본값은 **200**입니다.

`next_cursor`가 제공하는 값은 항상 문자열이며, 내부 구조를 알 수 없는 값으로 간주해야 합니다. 구현 방식은 변경될 수 있습니다. 결과 집합의 현재 페이지에서 반환된 엔티티 수가 `count`보다 적으면 `next_cursor` 값은 `null`이 됩니다.

**참고:** analytics 엔드포인트는 이 방식의 페이지네이션을 지원하지 않습니다. stats 엔드포인트의 페이징은 시간 구간을 지정하는 방식으로 지원됩니다. 자세한 내용은 각 엔드포인트의 문서를 참조하세요.