Una API de influencers para los datos de tus regalos.

Para qué sirve la API

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

Trabaja sobre tu propia lista, los creadores a los que 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 lo que buscas.

Claves, URL base y límites

• URL base: https://pozto.co/api/v1
• Claves: las crea el propietario del equipo en Ajustes → API, en el plan Brand. Una clave empieza por 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. En Ajustes ves cuándo se usó cada clave por última vez.
• Cómo enviarla: Authorization: Bearer pz_… en cada petición.
• Alcance: una clave lee y añade datos en todas las marcas de tu equipo.
• Límite de peticiones: 120 peticiones por minuto por clave.
• Páginas: GET /creators y GET /posts devuelven 100 de cada 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 siguen ISO 8601.

Endpoints

Qué incluyen un creador y una publicación

Un creador viene con su nombre, email, cuentas (y si se encontró cada usuario), códigos de descuento, estado y cada regalo: el producto y el resto de la caja, su campaña, las fechas de envío y entrega, el plazo en días, el número de seguimiento, la tarifa, las publicaciones pedidas y las que lleva hasta ahora.

Una publicación es un vídeo, con cada plataforma en la que se subió: enlace, texto, fecha de publicación y si te etiquetó. Después, el regalo y el producto a los que cuenta, y cómo lo decidió Pozto. Luego la revisión del vídeo: si se encontró tu producto, cada momento en pantalla en segundos, cada vez que se mencionó con la cita y un breve resumen. Y la indicación de publicidad: clara, débil o ninguna, con el motivo.

Añadir 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 añade el producto), shipped_at, delivered_at, due_days (21 si lo omites) y tracking. Un creador que ya está en la lista, identificado por cualquiera de sus cuentas o su email, 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 el dueño de la cuenta, que se añade a tu lista si es nuevo, y entra en cola para la revisión del vídeo. Responde si era nueva, el usuario, la plataforma y si cuenta como una publicación sobre ti.

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

# Añadir 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, de la más reciente a la más antigua
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 vuelve como JSON con una frase sencilla, como {"error": "…"}, y un estado 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 peticiones en un minuto.

Lo que la API no hace

• No busca influencers. Lee y añade datos en tu propia lista. La búsqueda de creadores está en Buscar creadores, dentro de la app.
• Las respuestas no incluyen visualizaciones, likes ni EMV. Están en la app desde Starter y en el informe semanal. Consulta informes de influencers.
• Sin webhooks. Para recoger publicaciones nuevas, llama a GET /posts con since.
• Sin ediciones ni borrados. La API lee y añade. Los cambios y las eliminaciones se hacen en la app.
• Sin claves personales. Las claves son del equipo y solo las crea el propietario.

Las publicaciones contienen lo mismo que en la app: Pozto encuentra publicaciones viendo el vídeo, los fotogramas, el audio y el texto, así que también llegan las publicaciones sin etiquetar. En seguimiento de influencers se explica 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 inferiores, y el plan gratuito cubre tus primeros 10 creadores. Ver planes.