Contoh berikut menunjukkan cara mengambil kumpulan hasil tambahan untuk kueri YouTube Data API (v3).
API menggunakan parameter maxResults untuk menunjukkan jumlah item yang harus disertakan dalam respons API. Hampir semua metode list API (videos.list, playlists.list, dll.) mendukung parameter tersebut.
Jika hasil tambahan tersedia untuk kueri, respons API akan berisi properti nextPageToken, properti prevPageToken, atau keduanya. Nilai properti tersebut kemudian dapat digunakan untuk menetapkan parameter pageToken guna mengambil halaman hasil tambahan.
Misalnya, kueri berikut mengambil hasil penelusuran untuk 10 video yang paling banyak ditonton yang cocok dengan kueri " skateboard":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
Respons API berisi 10 kecocokan pertama untuk kueri serta properti nextPageToken yang dapat digunakan untuk mengambil 10 hasil berikutnya:
Kueri di bawah mengambil 10 hasil berikutnya untuk kueri:
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
Catatan: Anda mungkin perlu memperbarui nilai parameter pageToken untuk menyelesaikan permintaan ini di API Explorer. Jalankan kueri yang mengambil 10 hasil pertama untuk mendapatkan nilai parameter pageToken yang benar.