Una API de influencers para tus datos de regalos.

Para qué sirve la API

Es para la persona de operaciones o el desarrollador que quiere los datos de Pozto en otro lado: una base de Airtable, un data warehouse, un dashboard, una herramienta interna. O al revés: agregar creadores desde el sistema que envía tus regalos, para que nadie los capture dos veces.

Funciona sobre tu propia lista, los creadores a los que les has enviado producto. No es una base de datos de influencers para buscar. Si eso es lo que necesitas de una API de influencers, Pozto no es la indicada.

Claves, URL base y límites

• URL base: https://pozto.co/api/v1
• Claves: las crea el dueño del equipo en Configuración → API, en el plan Brand. Una clave empieza con pz_ y se muestra una sola vez: Pozto solo guarda una huella, así que cópiala en ese momento. Ponle a cada clave un nombre según su uso y revócala cuando quieras. Configuración muestra cuándo se usó cada clave por última vez.
• Cómo enviarla: Authorization: Bearer pz_… en cada solicitud.
• Alcance: una clave lee y agrega en todas las marcas de tu equipo.
• Límite de solicitudes: 120 solicitudes por minuto por clave.
• Páginas: GET /creators y GET /posts devuelven 100 a la vez, o hasta 500 con &limit=. Cuando hay más, la respuesta incluye un next_cursor: envíalo de vuelta como &cursor= para la página siguiente. En la última página es null.
• Formato: JSON de entrada y de salida. Los ids son cadenas y las fechas van en ISO 8601.

Endpoints

Qué incluyen un creador y una publicación

Un creador viene con su nombre, correo, cuentas (y si se encontró cada usuario), códigos de descuento, estatus y cada regalo: el producto y el resto del paquete, su campaña, fechas de envío y entrega, el plazo en días, número de rastreo, tarifa, publicaciones pedidas y publicaciones hasta ahora.

Una publicación es un video, con cada plataforma donde se subió: enlace, descripción, fecha de publicación y si te etiquetó. Luego, el regalo y el producto al que cuenta, y cómo lo decidió Pozto. Después, la revisión de video: si se encontró tu producto, cada momento en pantalla en segundos, cada vez que se dijo con la cita y un breve resumen. Y la divulgación: clara, débil o ninguna, con el motivo.

Agregar creadores y publicaciones

POST /creators recibe brand_id y handles: @usuarios, enlaces de perfil o enlaces tipo Linktree, hasta seis. También acepta platform, name, email, codes, product (un id o un nombre; un nombre nuevo agrega el producto), shipped_at, delivered_at, due_days (21 si no lo incluyes) y tracking. Un creador que ya está en la lista, identificado por cualquiera de sus cuentas o su correo, recibe el regalo en lugar de duplicarse. Responde 201 para un creador nuevo y 200 para uno existente, con el id del creador y el id del regalo.

POST /posts recibe brand_id y url, y opcionalmente creator_id y product_id. La publicación se asigna a quien sea dueño de la cuenta, se agrega a tu lista si es nuevo y entra en la cola de la revisión de video. Responde si era nueva, el usuario, la plataforma y si cuenta como una publicación sobre ti.

# Creadores atrasados, en una marca
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Agregar un creador y el regalo que le enviaste
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# Publicaciones desde el 1 de octubre, las más nuevas primero
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# La página siguiente: el next_cursor de la respuesta anterior
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Errores

Un error regresa como JSON con una sola frase clara, como {"error": "…"}, y un estatus 4xx:

• 400: el cuerpo no es JSON, o un campo no es válido, como una fecha de entrega en el futuro.
• 401: no hay clave, o la clave es incorrecta o está revocada.
• 403: tu equipo no está en el plan Brand.
• 404: no hay ninguna marca con ese brand_id en tu equipo.
• 409: la marca está bloqueada, porque tu plan incluye menos marcas de las que usa tu equipo.
• 429: más de 120 solicitudes en un minuto.

Lo que no hace la API

• No busca influencers. Lee y agrega a tu propia lista. La búsqueda de creadores es Buscar creadores, en la app.
• No incluye vistas, likes ni EMV en las respuestas. Están en la app desde Starter y en el reporte semanal. Consulta reportes de influencers.
• No tiene webhooks. Para obtener publicaciones nuevas, consulta GET /posts con since.
• No edita ni borra. La API lee y agrega. Los cambios y las eliminaciones se hacen en la app.
• No hay claves por persona. Las claves son del equipo, y solo el dueño las crea.

Lo que trae cada publicación es lo mismo que en la app: Pozto encuentra publicaciones revisando el video, los cuadros, el audio y la descripción, así que también llegan las publicaciones sin etiqueta. En monitoreo de influencers explicamos cómo se encuentran las publicaciones.

Precios

La API viene con el plan Brand: $999 al mes, o $799 al mes con pago anual, con 10 marcas, 1,000 creadores activos, usuarios ilimitados e inicio de sesión único (SSO). Todo lo demás de Pozto empieza en planes más bajos, y el plan gratis cubre tus primeros 10 creadores. Ver planes.