Paginación

Para admitir un mayor número máximo de campañas y la recuperación eficiente de todas las entidades asociadas a una cuenta, la API de anuncios ahora incorpora paginación en muchos endpoints GET. El mecanismo de paginación es fácil de usar y muy similar a la paginación basada en cursores de la API REST, como se describe en Uso de cursores para navegar por colecciones.

​

Primeros pasos

Para determinadas solicitudes GET, ahora aceptamos los parámetros de consulta cursor y count, ambos opcionales. Si una respuesta contiene más de count entidades, estos endpoints devolverán las primeras count entidades y una clave next_cursor en el JSON de la respuesta.

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

{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}

Para obtener la siguiente serie de respuestas, agrega cursor a los parámetros de la consulta:

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

{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​

Profundización

En la mayoría de los endpoints, el valor máximo de count es 1.000, el mínimo es 1 y el valor predeterminado es 200.

El valor que devuelve next_cursor siempre es una cadena y debe considerarse opaco; la implementación está sujeta a cambios. Si en la página actual del conjunto de resultados se devuelven menos entidades que count, el valor de next_cursor será null.

Nota: los endpoints de analytics no admiten este estilo de paginación. La paginación en los endpoints de stats se realiza especificando períodos de tiempo. Consulta la documentación de esos endpoints para obtener más información.