Tus publicaciones,desde tu propio código.

Una clave. Todas las redes que conectes.

Programa, publica y sigue publicaciones desde tu tienda, tu app o las herramientas que ya usas. HTTP y JSON sencillos, con las mismas reglas y límites que todo lo demás en Spica Post.

Crear una clave Ver la referencia

Tres peticiones hasta una publicación programada.

Conecta tus cuentas una vez en la página de tu cuenta. Después tu código hace el resto: escribe la publicación, la revisa y elige la hora.

Crea una clave
En la página de tu cuenta, en la sección API keys. Se muestra una sola vez; guárdala como una contraseña.
```
Authorization: Bearer sp_live_…
```

Escribe la publicación

Una versión por cuenta, cada una con sus palabras y fotos. Todavía no sale nada.

POST /v1/drafts
{
  "title": "Pan recién hecho",
  "variants": [{
    "accountId": "…",
    "text": "Pan recién hecho desde las 7.",
    "mediaIds": ["…"]
  }]
}

Elige la hora
Envíala ya, a una hora o al siguiente hueco libre. Repetir una petición nunca publica dos veces. O escríbela y envíala de una vez con POST /v1/posts.
```
POST /v1/drafts/{id}/schedule
{
  "version": 1,
  "idempotencyKey": "b1f0…",
  "scheduledAt": "2026-11-06T14:00:00Z"
}
```

Entérate en el momento.

Añade una dirección tuya y Spica Post le avisa al instante, para que tu tienda, tu hoja de cálculo o el chat de tu equipo lo sepan sin preguntar.

post.published: Una publicación salió, con su enlace.
post.failed: No salió, y por qué, en palabras claras.
post.needs_check: La red todavía no dio una respuesta clara.
post.cancelled: Alguien la quitó de la programación.
account.needs_reconnect: Hay que volver a conectar una cuenta.

¿Tu servidor no responde? Cada aviso se vuelve a intentar solo, 8 veces durante un día, y la página de tu cuenta muestra lo que te llegó.

POST https://yourshop.com/hooks/spica
Spica-Event: post.published
Spica-Signature: t=1792641600,v1=5f2c…

{
  "type": "post.published",
  "data": { "delivery": {
    "network": "instagram",
    "state": "published",
    "url": "https://www.instagram.com/p/…"
  } }
}

Comprueba que viene de nosotros

hmac_sha256(secret, t + "." + body) == v1

Cada petición va firmada con un secreto que solo tienen tú y Spica Post.

Todo lo que hace tu asistente lo puede hacer tu código.

34 rutas. Cada una hace exactamente lo mismo que la herramienta del asistente que le corresponde, así que una publicación sigue las mismas reglas se haga como se haga. Todos los campos están en la referencia (en inglés). Ver la referencia

Cuentas

GET /v1/accounts
GET /v1/accounts/connect-links
GET /v1/accounts/{accountId}/recent-posts
DELETE /v1/accounts/{id}
GET /v1/capabilities

Archivos

GET /v1/media
POST /v1/media
POST /v1/media/from-url
DELETE /v1/media/{id}

Borradores

GET /v1/drafts
POST /v1/drafts
GET /v1/drafts/{id}
PATCH /v1/drafts/{id}
DELETE /v1/drafts/{id}
POST /v1/drafts/{id}/validate
POST /v1/check

Publicar

POST /v1/posts
POST /v1/drafts/{id}/publish
POST /v1/drafts/{id}/schedule
POST /v1/drafts/{id}/queue
GET /v1/queue
PUT /v1/queue
GET /v1/jobs
GET /v1/jobs/{id}
POST /v1/jobs/{id}/cancel
POST /v1/jobs/{id}/reschedule

Resultados

GET /v1/results

Plan

GET /v1/usage

Webhooks

GET /v1/webhooks
POST /v1/webhooks
PATCH /v1/webhooks/{id}
DELETE /v1/webhooks/{id}
POST /v1/webhooks/{id}/test
GET /v1/webhooks/{id}/events

Todos los planes de pagoLa API viene con Starter, Studio y Pro.
120 por minutoPeticiones que puede hacer cada clave.
5 clavesUna por app; revoca cualquiera al instante.
5 webhooksDirecciones que se enteran de tus publicaciones.

Respuestas

English

¿Es lo mismo que conectar mi asistente?

No. Tu asistente se conecta con un enlace y un inicio de sesión, sin clave. Una clave es para programas que escribes tú o tu desarrollador.

¿Necesito mis propias cuentas de desarrollador en cada red?

No. Conectas tus cuentas en la página de tu cuenta, como siempre. Tu clave solo llega a tu propia cuenta de Spica Post.

¿Qué pasa si una publicación falla?

La respuesta dice por qué en una frase, y un webhook avisa a tu dirección al instante. Repetir una petición con la misma clave de idempotencia nunca publica dos veces.

¿Dónde está la lista completa de campos?

En la referencia de la API, un documento OpenAPI estándar que herramientas como Postman y la mayoría de generadores de código leen tal cual.

Tu primera publicación desde tu código, hoy.

Crear una clave

¿Prefieres pedirlo? Tu asistente hace todo esto con un enlace y sin clave.