다음 예는 YouTube Data API (v3) 쿼리에 대한 추가 결과 집합을 검색하는 방법을 보여줍니다.
API는 maxResults 매개변수를 사용하여 API 응답에 포함해야 하는 항목 수를 나타냅니다. 거의 모든 API의 list 메서드(videos.list, playlists.list 등)가 이 매개변수를 지원합니다.
쿼리에 대한 추가 결과가 제공되면 API 응답에 nextPageToken 속성, prevPageToken 속성 또는 둘 다 포함됩니다. 그런 다음 속성의 값을 사용하여 pageToken 매개변수를 설정하여 추가 결과 페이지를 검색할 수 있습니다.
예를 들어 다음 쿼리는 'skateboarding dog' 검색어와 일치하는 상위 10개 동영상의 검색결과를 검색합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
API 응답에는 쿼리의 처음 10개 일치 항목 및 다음 10개 결과를 검색하는 데 사용할 수 있는 nextPageToken 속성이 포함됩니다.
아래 쿼리는 쿼리의 다음 결과 10개를 검색합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &pageToken=CAoQAA &q=skateboarding+dog &type=video
참고: pageToken 매개변수의 값을 업데이트하여 API 탐색기에서 이 요청을 완료해야 할 수도 있습니다. 처음 10개의 결과를 검색하는 쿼리를 실행하여 올바른 pageToken 매개변수 값을 가져옵니다.