antworkDOCS

API REST

Crea, edita, envía y sigue publicaciones en tus cuentas conectadas, en las catorce redes que admite Antwork, desde un servidor, con una clave de API. El mismo motor que las herramientas MCP de Antwork: publicaciones y campañas, medios, espacios de trabajo, cuentas y analítica.

Versiónv1AutenticaciónClave de APILímite10.000/día
https://antwork.io/api/v1

URL base y autenticación

Todos los endpoints cuelgan de esta URL y reciben una clave de API en la cabecera Authorization. Cómo crearla se explica en Claves de API y permisos.

Authorization
Authorization: Bearer ak_a1b2c3d4e5f6a7b8_<secret>

Cada petición lleva una clave de API como bearer token. Las claves son para servidores. Si lo que quieres es conectar un asistente en vez de escribir código, usa el servidor MCP: se autentica en el navegador y no necesita ninguna clave.

Endpoints

Cada endpoint tiene su propia página, con la petición en cURL, Node.js y Python.

POST /v1/posts
Crea una publicación por cuenta, ahora o programada.
GET /v1/posts/{id}
Una publicación y qué fue de ella.
GET /v1/posts
Todas tus publicaciones, de la más reciente a la más antigua.
PATCH /v1/posts/{id}
Cambia el texto, los hashtags, la cuenta, los ajustes o la hora de una publicación.
PUT /v1/posts/{id}/media
Fija los medios de una publicación, en orden.
POST /v1/posts/{id}/publish
Envía ya una publicación guardada; una fallida se reintenta.
POST /v1/posts/{id}/schedule
Programa una publicación guardada o mueve una programada.
POST /v1/posts/{id}/unschedule
Devuelve una publicación programada a borrador.
POST /v1/campaigns/{id}/publish
Envía ya todas las publicaciones de una campaña.
POST /v1/campaigns/{id}/schedule
Programa todas las publicaciones de una campaña a la misma hora.
DELETE /v1/posts/{id}
Cancela o elimina una publicación y, si quieres, también la publicada.
GET /v1/accounts
Tus cuentas conectadas y sus ids.
GET /v1/accounts/{id}
Una cuenta, sus ajustes de publicación y sus tableros de Pinterest.
POST /v1/accounts/{id}/platform-posts:fetch
Las publicaciones recientes de una cuenta, leídas de la plataforma.
GET /v1/workspaces
Tus espacios de trabajo y sus ids.
POST /v1/workspaces
Crea un espacio de trabajo.
PATCH /v1/workspaces/{id}
Cambia el nombre, la web, el logo o los ajustes de un espacio.
GET /v1/workspaces/{id}/connect-urls
Enlaces que conectan una cuenta a un espacio.
GET /v1/platforms
Qué acepta cada plataforma: límites, medios, topes y ajustes.
GET /v1/analytics/performance
Métricas por publicación y por plataforma.
GET /v1/analytics/daily
Interacción por día y por plataforma; o el historial de una publicación.
GET /v1/usage
Tu plan y tu posición de cuota.
GET /v1/media
Tu biblioteca de medios.
POST /v1/media
Añade un archivo a la biblioteca de medios desde un enlace.
DELETE /v1/media/{id}
Quita un archivo de la biblioteca.

Toda la API está descrita también en OpenAPI 3.1 en https://antwork.io/openapi.json, generada a partir de las mismas especificaciones de endpoint contra las que se prueban las rutas. Impórtala en Postman o Insomnia, o genera un cliente a partir de ella.

Límites de uso

10.000/día

Cada clave permite 10.000 peticiones al día y 120 por minuto. Los topes existen para frenar un bucle descontrolado, no para racionar el uso normal. Si te acercas a alguno, escríbenos en vez de sortearlo.

Headers
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9812
X-RateLimit-Reset: 1790035200
Retry-After: 37

Todas las respuestas llevan el presupuesto actual, no solo las rechazadas, así que nunca hace falta agotar el límite para conocerlo. X-RateLimit-Reset es un timestamp Unix; Retry-After solo aparece en un 429 y va en segundos.

Las peticiones se cuentan pero no se facturan. Antwork cobra por sus planes, no por llamada, así que esto es un tope de uso razonable y no un contador de facturación.

¿Algo no cuadra? Dinos cuál.