Poniższy przykład pokazuje, jak pobrać dodatkowe zestawy wyników dla zapytań dotyczących YouTube Data API (v3).
Interfejs API używa parametru maxResults do określenia liczby elementów, które należy uwzględnić w odpowiedzi interfejsu API. Prawie wszystkie metody interfejsu API list (videos.list, playlists.list itp.) obsługują ten parametr.
Jeśli dla zapytania dostępne są dodatkowe wyniki, odpowiedź interfejsu API będzie zawierała właściwość nextPageToken, właściwość prevPageToken lub obie te wartości. Wartości tych właściwości można następnie wykorzystać do ustawienia parametru pageToken na pobieranie dodatkowej strony wyników.
Poniższe zapytanie pozwala na przykład wyświetlić wyniki wyszukiwania 10 najczęściej oglądanych filmów pasujących do zapytania „pies deskorolkowy”:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
Odpowiedź interfejsu API zawiera 10 pierwszych dopasowań do zapytania i właściwość nextPageToken, której można użyć do pobrania kolejnych 10 wyników:
Poniższe zapytanie pozwala pobrać 10 kolejnych wyników:
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
Uwaga: do ukończenia tego żądania w Eksploratorze interfejsów API może być konieczna aktualizacja wartości parametru pageToken. Wykonaj zapytanie, które pobiera pierwsze 10 wyników, aby uzyskać prawidłową wartość parametru pageToken.