Referencia de endpoints

Todos los endpoints están bajo el prefijo /api/v1/public/ en https://api.vibevo.io y requieren una clave de API con el scope adecuado.

Identidad de la clave

• GET /me — identidad de la clave actual (propietario, scopes).

Campañas

• GET /campaigns — lista de campañas. Scope read. Cursor.
• GET /campaigns/{id} — una campaña. Scope read.
• GET /campaigns/{id}/posts — publicaciones. Scope read. Cursor + filtro de estado opcional.
• GET /campaigns/{id}/creators — creadores agregados por cuenta, ordenados por vistas. Scope read.
• GET /campaigns/{id}/tracking-links — enlaces de seguimiento con uniqueClicks. Scope read.

Ofertas (para creadores)

• GET /offers — el muro de ofertas del creador (campañas RUNNING) con términos para el creador (tarifa/CPM, requisitos, takenAt), sin el presupuesto/gasto del anunciante. Scope read.
• GET /posts — tus publicaciones enviadas en todas las campañas: estado, vistas, ganancias, campaña, cuenta y fecha de envío, más un summary (total, en moderación, ganado en total). Scope read. Cursor + filtros opcionales status / platform.

Analítica

• GET /analytics/campaigns/{id} — analítica de campaña. Scope read.

Cartera

• GET /wallet — saldo actual. Scope read.
• GET /wallet/transactions — historial de facturación. Scope read. Cursor.

Paginación por cursor

Los endpoints de lista usan cursor. Pasa limit (1 a 100) y cursor:

GET /api/v1/public/campaigns?limit=50&cursor=1234

{
  "data": [ /* ... */ ],
  "nextCursor": "5678"
}

Formato de dinero

Los valores monetarios se devuelven como { raw, currency, decimals }, donde raw es un entero en unidades mínimas enviado como cadena; el valor real = raw / 10^decimals. Presupuestos de campaña e ingresos por publicación son céntimos (decimals: 2, USD); el saldo de la cartera y las transacciones de facturación son unidades mínimas de USDT (decimals: 6).

Formato de errores

{
  "statusCode": 403,
  "code": "insufficient_scope",
  "message": "Missing required scope: read",
  "timestamp": "2026-07-11T12:00:00.000Z",
  "path": "/api/v1/public/campaigns"
}

Usa el campo de cadena code para el manejo programático.

Ejemplos con curl

curl https://api.vibevo.io/api/v1/public/campaigns?limit=20 \
  -H "Authorization: Bearer vibevo_live_ab12cd.xxxxxxxxxxxxxxxx"

curl https://api.vibevo.io/api/v1/public/wallet \
  -H "X-API-Key: vibevo_live_ab12cd.xxxxxxxxxxxxxxxx"

Actualizado: 11 de julio de 2026