API de redes sociales: una clave para publicar en 9 redes

Antwork es una API de redes sociales con una sola clave para X (Twitter), LinkedIn, Facebook, Threads, Instagram, YouTube, TikTok, Pinterest y Bluesky. Tu código llama a la API REST para publicar o programar en cualquiera de ellas, y la misma clave sirve a un agente en el endpoint MCP de Antwork. No construyes ninguna app de plataforma ni pasas ninguna revisión: conectas cada cuenta una vez en Antwork y publicas en ella por su id.

Endpoints

Cinco endpoints, todos bajo https://antwork.io/api/v1 y todos autenticados con la misma clave:

• POST /posts crea una publicación por cuenta de destino. Hasta 25 cuentas por petición, con texto propio por cuenta en texts, o una entrada por publicación en posts, cada una con sus hashtags, etiquetas, medios y ajustes. Responde 202 con un resultado por destino, porque cada destino falla por separado: que X rechace un texto largo no cancela la publicación de LinkedIn de al lado.
• GET /posts/{id} devuelve una publicación y su estado. La publicación ocurre en segundo plano, así que así ves cuándo sale.
• GET /posts lista tus publicaciones, filtradas por status y paginadas con un cursor, hasta 100 por página.
• DELETE /posts/{id} borra una publicación de Antwork. Con deleteFromPlatform=true también encola el borrado de la publicación en la red, e indica qué redes no lo permiten.
• GET /accounts lista las cuentas que conectaste, con sus ids y el estado de su token.

Envía una cabecera Idempotency-Key en POST /posts y una petición reintentada devuelve la primera respuesta en vez de publicar dos veces. Los campos y cada código de error están en la referencia de la API.

Tu primera publicación en dos peticiones

Crea una clave en Ajustes → Desarrollador y después:

# 1 · lista las cuentas que conectaste
curl https://antwork.io/api/v1/accounts \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

# 2 · crea y programa una publicación
curl https://antwork.io/api/v1/posts \
  -H "Authorization: Bearer $ANTWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-post-1" \
  -d '{"accounts":["<accountId>"],"text":"Hoy he lanzado la v2.","scheduledFor":"2026-11-03T09:00:00Z"}'

Omite scheduledFor para publicar ya, o envía "draft": true para guardarla y revisarla. Un borrador necesita el permiso write; una publicación que sale necesita publish. Los medios van en media como URLs de tu biblioteca de Antwork: una URL externa se rechaza con media_not_hosted antes de crear nada, en vez de fallar al publicar.

TikTok, y la misma clave para agentes

La API REST acepta X (Twitter), LinkedIn, Facebook, Threads, Instagram, YouTube, TikTok, Pinterest y Bluesky. TikTok es la única red en la que una persona sigue en el proceso: TikTok exige que el dueño de la cuenta elija la audiencia de cada publicación, así que tu código crea la publicación de TikTok como borrador y el dueño elige la audiencia en Antwork, en el settingsUrl del borrador. Hasta entonces, publicarla se rechaza con tiktok_privacy_required.

Para un agente, envía la misma clave al endpoint MCP de Antwork, al que cualquier cliente MCP o SDK de agentes puede llamar con una cabecera fija:

claude mcp add --transport http antwork https://api.antwork.io/mcp \
  --header "Authorization: Bearer $ANTWORK_API_KEY"

Los permisos funcionan igual en las dos superficies. La configuración para Codex y para el Claude Agent SDK en TypeScript y Python está en la referencia MCP. Instagram solo conecta cuentas de Creador o Empresa; el cambio es gratis y no necesita página de Facebook.

Qué exige cada red

Cada publicación se comprueba contra estas reglas en las dos superficies: un borrador se marca, y una publicación que incumple una se rechaza antes de publicarse. La tabla se genera desde el mismo archivo de reglas con el que validan los publicadores, así que no puede contradecir lo que aplica la API. Un pin de Pinterest va además a un tablero, elegido entre los de la cuenta. Tamaños, formatos y duraciones máximas están en especificaciones por plataforma.

Precios

La API cuesta lo mismo que la app. Las primeras 2 cuentas conectadas son gratis, y cada cuenta después cuesta 5 $ al mes. Ningún plan cuenta publicaciones y la API no tiene cuota aparte. Cada clave tiene un techo de 10.000 llamadas al día y 120 por minuto, para frenar bucles descontrolados, no para racionar el uso normal. Consulta los precios.

Cuándo encaja mejor otra API

Si necesitas Reddit, Snapchat, Telegram, WhatsApp o Google Business Profile, Ayrshare los incluye y Antwork no. Si ya programas con Buffer, su API GraphQL llega a los canales que tienes allí. Antwork encaja cuando publicas para una marca, quieres empezar gratis y quieres que tu agente y tu código usen las mismas cuentas.