antworkDOCS

Obtener una cuenta

Una cuenta conectada, los ajustes que admite una publicación en ella, su límite diario y, en Pinterest, sus tableros.

GEThttps://antwork.io/api/v1/accounts/{id}Permisoread

Petición

curl https://antwork.io/api/v1/accounts/acc_pinterest \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

La cuenta tal como la lista GET /api/v1/accounts, más settings, los campos por publicación que admite su plataforma. Requiere el permiso read.

Respuesta

200 OK
{
  "object": "account",
  "id": "acc_pinterest",
  "workspaceId": "ws_...",
  "platform": "pinterest",
  "name": "Antwork",
  "handle": "antwork",
  "accountType": "business",
  "active": true,
  "tokenHealth": "healthy",
  "connectedAt": "2026-01-05T09:00:00.000Z",
  "settings": [
    {
      "key": "pinTitle",
      "label": "Pin title",
      "type": "text",
      "maxLength": 100,
      "placeholder": "Optional"
    },
    {
      "key": "link",
      "label": "Destination link",
      "type": "url",
      "maxLength": 2048,
      "placeholder": "https://…"
    }
  ],
  "boards": [
    { "id": "1234567890", "name": "Product updates" }
  ],
  "dailyPostCap": { "limit": 15, "windowHours": 24, "tier": "free", "publishedLast24h": 1, "scheduledNext24h": 1, "remaining": 13 }
}

En Pinterest, boards es la lista de tableros de la cuenta en este momento. Un pin va a un tablero, y de aquí sale su id. Si Pinterest rechaza la consulta, boards es null y boardsError dice por qué; reconnect: true significa que hay que volver a conectar la cuenta en Antwork.

dailyPostCap es cuántas publicaciones puede hacer esta cuenta en cualquier periodo de 24 horas con tu plan, lo que ha publicado en las últimas 24 y tiene programado en las próximas 24, y lo que queda tras ambas: limit, publishedLast24h, scheduledNext24h y remaining. Es el límite que aplican publish y schedule (daily_cap_reached). Las cifras por plataforma están en GET /api/v1/platforms.

nextFreeAt, junto a remaining, es el primer momento en que una publicación nueva cabe en el límite y en el intervalo mínimo entre publicaciones: ahora si queda margen, o null si nada cabe en los próximos dos días. Programa ahí en lugar de contar tú las publicaciones recientes de la cuenta.

include=recentPosts añade hasta 15 publicaciones de la cuenta con sus métricas, la misma lista que la herramienta MCP get_post_context da a una IA como la voz de la cuenta. Se leen de la plataforma (las lecturas de X se guardan una semana), así que cuentan para el límite de lecturas de plataforma, 10 por clave cada 10 minutos. Un perfil personal de LinkedIn no se puede leer, así que sus publicaciones son las publicadas con Antwork. include=bestTimes añade las horas sugeridas que muestra el editor. Combínalos con una coma.

Una cuenta que no existe o no es tuya responde 404 con account_not_found.

¿Algo no cuadra? Dinos cuál.