O exemplo a seguir mostra como recuperar outros conjuntos de resultados para consultas da API Data do YouTube (v3).
A API usa o parâmetro maxResults para indicar quantos itens devem ser incluídos em uma resposta da API. Quase todos os métodos list da API (videos.list, playlists.list etc.) são compatíveis com esse parâmetro.
Se houver outros resultados disponíveis para uma consulta, a resposta da API vai conter uma propriedade nextPageToken, uma propriedade prevPageToken ou ambas. Os valores dessas propriedades podem ser usados para definir o parâmetro pageToken e recuperar outra página de resultados.
Por exemplo, a consulta a seguir recupera os resultados de pesquisa dos 10 vídeos mais visualizados que correspondem à consulta "skateboarding dog":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
A resposta da API contém as primeiras 10 correspondências da consulta, além de uma propriedade nextPageToken que pode ser usada para recuperar os próximos 10 resultados:
A consulta abaixo recupera os próximos 10 resultados:
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
Observação:talvez seja necessário atualizar o valor do parâmetro pageToken para concluir essa solicitação no APIs Explorer. Execute a consulta que recupera os 10 primeiros resultados para conseguir o valor correto do parâmetro pageToken.