Help articles are written in Spanish for now; the English version is on its way. Product names (AI Rank, BGPi, MCP) are the same.

Reference

Paginación, CSV y el parámetro ?cliente

limite y cursor, la respuesta paginacion.siguiente, ?format=csv y cómo leer datos de un cliente de agencia.

Paginación#

Solo se aplica si la pides:

  • ?limite=N: elementos por página (por defecto 50, máximo 200).
  • ?cursor=…: el cursor que te dio la página anterior.

La respuesta añade:

"paginacion": { "limite": 50, "total": 312, "siguiente": "eyJsIjoi…" }

Cuando siguiente es null, no hay más. El cursor es opaco y solo vale para la ruta que lo generó; si no es válido, recibes 400 cursor_invalido.

Las rutas del archivo#

mediciones, respuestas, acciones y citas responden con otra forma: { "datos": [...], "n", "siguiente", "cursor" }. Para la página siguiente, pasa el cursor que recibes. mediciones devuelve hasta 100 por página y respuestas hasta 1000 (500 por defecto).

CSV#

Añade ?format=csv para recibir la lista principal de la ruta en CSV. En rutas sin lista recibes csv_no_disponible.

Datos de un cliente (agencias)#

Añade ?cliente=<id> (los ids salen de GET /api/v1/clientes). Funciona en: airank, airank/history, visibility, visibility/history, rank2, mediciones, respuestas y products.

ErrorQué significa
cliente_no_encontradoEse id no es de tu cartera
cliente_no_disponibleEsa ruta no tiene datos por cliente: VisibAI no te devuelve los de la cuenta como si fueran del cliente

Updated on

Related articles

Didn’t find your answer?

Write to us and we will reply. If you have an account, use “Contact us” in the dashboard: it reaches us with your account context.