API de Superpills

Publica y lee tus vistas desde tu propio código

  • Una API REST con las mismas 8 herramientas que tu IA.
  • Una clave desde Configuración › Desarrolladores. No tienes que armar una app de OAuth.
  • Una herramienta de línea de comandos en un solo archivo, que solo necesita Node.js.

Actualizado: octubre de 2026 · Incluida en Pro, Max y la prueba de 7 días.

Una píldora verde lima concentrada, acostada frente a una torre de bloques de colores pastel, con un cable enrollado.
Envié 3 fotos a la bandeja de TikTok de @tumarcaPOST /api/v1/tiktok-drafts · 200

Así funciona

De tu terminal a tu bandeja de TikTok.

Un comando manda tres fotos. Llega el aviso de TikTok, abres el borrador, le pones sonido y lo publicas.

¿Cómo empiezo?

Creas una clave en Superpills, pruebas una llamada y después usas la API o la línea de comandos. Toma unos minutos.

  1. 1

    Crea tu clave

    En Superpills, abre Configuración › Desarrolladores y toca Crear clave de API. Se muestra una sola vez: Superpills guarda solo una huella de ella.

    Empezar gratis
  2. 2

    Prueba una llamada

    Lista tus cuentas. Pon tu clave donde dice spk_….

    curl https://superpills.app/api/v1/channels -H "Authorization: Bearer spk_…"
  3. 3

    O usa la línea de comandos

    Bajas un archivo e inicias sesión una vez. Necesita Node.js 18 o más reciente, y nada más.

    curl -o superpills.mjs https://superpills.app/cli/superpills.mjs

¿Qué endpoints hay?

8, bajo https://superpills.app/api/v1/, uno por cada herramienta de tu IA. Cada llamada lleva tu clave como "Authorization: Bearer spk_…", y cada respuesta es JSON.

Endpoints

GET /channelsTus marcas y sus cuentas conectadas.
GET /views?days=7&channel=@handleVistas nuevas por día y por cuenta, hasta 365 días atrás.
GET /top-posts?days=30&limit=10Los posts con más vistas.
POST /tiktok-draftsManda de 1 a 35 fotos a una bandeja de TikTok como borrador.
GET /draft-status?channel=@handle&publish_id=…Si un borrador ya llegó a TikTok.
POST /schedulePrograma texto, fotos o un video en hasta 30 cuentas. Espera tu OK.
GET /posts?days=30Lo programado, y cómo salieron los posts de los últimos 7 días.
POST /cancel-postBorra un post que todavía no salió.

¿Cómo se ve una llamada?

Tres ejemplos con curl. Las fotos pueden ser enlaces https o data URIs; Superpills las convierte para cada red.

Manda un carrusel a TikTok como borrador

curl https://superpills.app/api/v1/tiktok-drafts \
  -H "Authorization: Bearer $SUPERPILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "@tumarca",
    "images": ["https://example.com/1.png", "https://example.com/2.png", "https://example.com/3.png"],
    "caption": "Tres cosas que lanzamos esta semana #lanzamiento",
    "cover_index": 0
  }'

Programa un post que espera tu OK

curl https://superpills.app/api/v1/schedule \
  -H "Authorization: Bearer $SUPERPILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": ["@tumarca"],
    "caption": "Ya llegó nuestro menú nuevo",
    "images": ["https://example.com/menu.jpg"],
    "publish_at": "2026-10-20T18:00:00-05:00"
  }'

Lee las vistas de la última semana

curl "https://superpills.app/api/v1/views?days=7" \
  -H "Authorization: Bearer $SUPERPILLS_API_KEY"

¿Cómo uso la línea de comandos?

La bajas, inicias sesión con tu clave y pides. La clave se guarda en tu carpeta de usuario, o se lee de SUPERPILLS_API_KEY. Agrega --json a cualquier comando para ver la respuesta tal cual.

Instala e inicia sesión

curl -o superpills.mjs https://superpills.app/cli/superpills.mjs
node superpills.mjs login

Lee tus vistas y tus mejores posts

node superpills.mjs views --days 7
node superpills.mjs top --days 30 --limit 5

Manda un carrusel a TikTok como borrador

node superpills.mjs draft --channel @tumarca --caption "Lanzamos hoy" foto1.png foto2.png foto3.png

¿Qué responde la API cuando algo sale mal?

Un JSON con un "error" que dice qué arreglar, y uno de estos códigos.

Errores

400Algo de la llamada está mal, como un campo que falta o demasiadas fotos.
401Falta la clave, está mal o fue reemplazada.
402Tu plan o tu prueba terminó.
404No hay un endpoint con ese nombre.
405Método equivocado: usa GET o POST como dice la lista.

¿API o MCP: cuál uso?

Usa MCP cuando el trabajo lo hace una IA: Claude, ChatGPT o Cursor agregan una dirección e inician sesión. Usa la API cuando lo hace tu propio código: un script, una tarea programada, n8n o Make. Las dos usan las mismas herramientas con los mismos límites.

Preguntas frecuentes

¿La API cuesta extra?

No. Viene con Pro ($19 al mes) y Max ($49), y funciona durante la prueba de 7 días.

¿Los posts que programo con la API salen solos?

No. Igual que los que programa tu IA, esperan tu OK en el calendario de Superpills. Las fotos y los videos de TikTok llegan a la bandeja como borrador.

¿Puedo hacer una app que publique por otras personas?

Todavía no. Una clave solo llega a tus propias marcas y cuentas.

¿Y si se filtra mi clave?

Reemplázala en Configuración › Desarrolladores. La anterior deja de funcionar al instante.

¿La puedo usar desde n8n, Make o Zapier?

Sí. Sirve cualquier herramienta que pueda mandar una llamada HTTP con un encabezado: agrega tu clave como "Authorization: Bearer spk_…".

Sigue con

Tu código publica. Tú apruebas.

7 días gratis. Conectas tu IA en un minuto.