Dropsify Developers

Crea tiendas y publica vídeos en Instagram, Facebook y TikTok desde tus propias apps —n8n, Zapier, tu backend— con una clave de API.

Antes de empezar

La API va incluida desde el plan Starter en adelante —Starter, Creator, Pro y Agency—, sin coste aparte y sin pagar por uso. No está disponible en el plan gratis.

La clave se crea en tu panel: menú lateral → Cuenta → Developers → + Crear clave. Marcas ahí qué puede hacer esa clave. Se muestra una sola vez: al cerrar la ventana no se puede volver a ver, porque no la guardamos — solo su huella. Si la pierdes, revócala y crea otra.

Autenticación

Todas las llamadas van sobre https://dropsify.app/v1 con tu clave en la cabecera:

Authorization: Bearer dk_live_tu_clave

Sin clave, con una clave inválida o revocada: 401.

Permisos

Cada clave lleva solo los permisos que le marques. Si llamas a un endpoint sin el permiso que pide, recibes 403 con "code": "scope".

Al publicar, el permiso se comprueba por red: una llamada a dos redes necesita los dos permisos.

Errores

Los errores devuelven { "error": "…", "code": "…" }. El error es un texto para leer; el code es lo que debes mirar desde tu programa.

Códigos de negocio

Límites de uso

Al pasarte recibes 429; espera unos segundos y reintenta.

Créditos: qué cuesta y qué no

Usar la API no lleva ningún recargo: lo que cuesta dinero cuesta lo mismo por API que a mano. Tu saldo: GET /v1/credits.

Idempotencia

En los POST que crean o publican, manda una cabecera con un valor único tuyo:

Idempotency-Key: cualquier-valor-unico-tuyo

• Si reintentas con la misma clave, no se duplica: te devolvemos la misma respuesta que la primera vez.
• Si la primera llamada todavía se está ejecutando, la segunda recibe 409 con "code": "in_progress".
• Solo se recuerdan las respuestas correctas. Si la primera falló (por ejemplo 402 sin saldo), el reintento se ejecuta de verdad.
• La clave vale 24 horas y es de ese endpoint: la misma Idempotency-Key en dos rutas distintas no se cruza.

El vídeo que mandas

Tú das una URL pública y nuestro servidor descarga el vídeo para subirlo a la red.

Publicar fotos por API todavía no está disponible: de momento, vídeo.

El texto de la publicación

El campo caption admite hasta 2200 caracteres, que es el máximo de TikTok e Instagram. Si te pasas, la llamada se rechaza con 400 y "code": "w_caption_larga" diciéndote cuántos llevas — nunca te lo recortamos por detrás.

Recuerda que Instagram admite como mucho 30 hashtags y 20 menciones.

Perfiles y publicar sin tienda

Si solo quieres usar Dropsify para publicar, no necesitas crear ninguna tienda. Conecta tus cuentas una vez desde el panel y publica contra el perfil que quieras.

GET https://dropsify.app/v1/profiles
Authorization: Bearer dk_live_tu_clave

{ "profiles": [
  { "id": "ac_abc", "networks": ["tiktok"], "network": "tiktok",
    "provider": "tiktok", "label": "Mi TikTok", "account": "micuenta" },
  { "id": "ac_def", "networks": ["fb","ig"], "network": "fb",
    "provider": "meta", "label": "Mi página", "account": "Mi Página" }
] }

POST https://dropsify.app/v1/publish
Authorization: Bearer dk_live_tu_clave
Content-Type: application/json
Idempotency-Key: mi-valor-unico

{
  "network":    "tiktok",
  "profile_id": "ac_abc",
  "video":      "https://tu-servidor.com/video.mp4",
  "caption":    "mi producto 🔥",
  "tt": { "privacy": "PUBLIC_TO_EVERYONE" }
}

→ 202  { "ok": true, "post_id": "p_…", "job_id": "j_…", "status": "scheduled" }

Publicar desde una tienda

POST https://dropsify.app/v1/stores/st_abc/posts
Authorization: Bearer dk_live_tu_clave
Content-Type: application/json

{
  "network": "ig,fb",
  "video":   "https://tu-servidor.com/mi-video.mp4",
  "caption": "Mi producto 🔥 #oferta",
  "run_at":  "2026-08-20T18:00:00Z"
}

→ 202  { "ok": true, "post_id": "p_…", "job_id": "j_…", "status": "scheduled" }

Campos

{ "store_id": "st_abc",
  "connections": {
    "ig":     { "connected": true,  "account": "@mitienda" },
    "fb":     { "connected": false },
    "tiktok": { "connected": true,  "account": "mitiktok" } } }

Historial de publicaciones

{ "posts": [ { "id": "p_…", "store_id": null, "network": "tiktok",
               "status": "published", "result_url": "https://…",
               "error": null, "created_at": "2026-08-11 12:46:17" } ] }

Pedidos

Tus ventas, para llevarlas a tu ERP, tu hoja de cálculo o el flujo que uses. Solo las de tus tiendas.

GET https://dropsify.app/v1/orders?status=shipped&limit=50
Authorization: Bearer dk_live_tu_clave

{ "orders": [ {
  "id": "o_abc", "store_id": "st_abc", "status": "shipped",
  "amount_cents": 1990, "refunded_cents": 0,
  "customer": { "name": "…", "email": "…", "address": { } },
  "items": [ { "name": "…", "qty": 1 } ],
  "tracking": null, "carrier": null, "coupon": null,
  "created_at": "2026-08-12 09:14:02",
  "history": [ ]
} ] }

Tiendas

POST https://dropsify.app/v1/stores
Authorization: Bearer dk_live_tu_clave
Content-Type: application/json
Idempotency-Key: mi-valor-unico

{ "link": "https://es.aliexpress.com/item/…",
  "name": "Mi producto",
  "price": "19,90" }

→ 202  { "ok": true, "store": { "id": "st_…", "slug": "mi-producto", "status": "building" }, "job_id": "j_…" }

{ "stores": [ { "id": "st_…", "slug": "mi-producto", "title": "Mi producto",
                "status": "live", "url": "https://…" } ] }

Trabajos y saldo

{ "job": { "id": "j_…", "type": "store.create", "status": "done",
           "progress": 100, "error": null,
           "created_at": "…", "finished_at": "…" } }

{ "balance": 5120 }

Recetas completas

Publicar en TikTok desde n8n

1. Panel → Cuenta → Developers → crear clave con publish:tt y stores:read.
2. Nodo HTTP Request: GET https://dropsify.app/v1/profiles con la cabecera Authorization. Apunta el id del perfil de TikTok.
3. Nodo HTTP Request: POST https://dropsify.app/v1/publish con el cuerpo del ejemplo de arriba y el profile_id del paso 2.
4. Opcional: GET /v1/posts/{post_id} para confirmar que pasó a published y recoger la result_url.

Pon una Idempotency-Key distinta por vídeo (por ejemplo el id del vídeo): si n8n reintenta, no se publica dos veces.

Crear una tienda y esperar a que esté lista

POST /v1/stores            → 202 { "store": { "id": "st_x" }, "job_id": "j_x" }
GET  /v1/jobs/j_x          → { "job": { "status": "running" } }
GET  /v1/jobs/j_x          → { "job": { "status": "done" } }
GET  /v1/stores/st_x       → { "store": { "status": "live", "url": "https://…" } }