Obtener Post - dopost Docs

GET

/api/v1/post/{postId}

Obtén los detalles completos de un post incluyendo su estado, contenido y programación.

Petición

Reemplaza {postId} con el postId devuelto por el endpoint de Publicación.

curl -H "x-api-key: <apiKey>" \
  https://dopost.co/api/v1/post/<postId>

curl -H "x-api-key: <apiKey>" \
  https://dopost.co/api/v1/post/<postId>

Respuesta

200 OK

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "LINKEDIN",
  "text": "¡Hola desde la API de dopost!",
  "media": [],
  "postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "LINKEDIN",
    "platformUsername": "johndoe"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2025-06-01T12:00:00.000Z",
  "updatedAt": "2025-06-01T12:00:05.000Z"
}

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "LINKEDIN",
  "text": "¡Hola desde la API de dopost!",
  "media": [],
  "postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "LINKEDIN",
    "platformUsername": "johndoe"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2025-06-01T12:00:00.000Z",
  "updatedAt": "2025-06-01T12:00:05.000Z"
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	`string`	ID único del post
`status`	`string`	`PENDING`, `PUBLISHED`, `FAILED` o `DRAFT`
`platform`	`string`	Plataforma social de destino
`text`	`string \| null`	Texto del post
`media`	`array`	URLs de media adjuntas al post
`postUrl`	`string \| null`	URL del post publicado en la plataforma (disponible tras publicar)
`account`	`object`	Cuenta social a la que se publicó el post
`schedule`	`object \| null`	Detalles de programación si el post fue programado
`jobId`	`string \| null`	ID de grupo para seguimiento con el endpoint de Estado
`source`	`string`	Origen del post (`api`, `dashboard`)
`createdAt`	`string`	Fecha de creación ISO 8601
`updatedAt`	`string`	Fecha de última actualización ISO 8601

Ejemplo de post programado

{
  "id": "cm3def456ghi789",
  "status": "PENDING",
  "platform": "INSTAGRAM",
  "text": "¡Próximamente!",
  "media": ["https://cdn.dopost.co/uploads/foto.jpg"],
  "postUrl": null,
  "account": {
    "id": "cm3jkl012mno345",
    "platform": "INSTAGRAM",
    "platformUsername": "janedoe"
  },
  "schedule": {
    "scheduledFor": "2025-12-25T12:00:00.000Z",
    "status": "SCHEDULED",
    "publishedAt": null
  },
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "source": "api",
  "createdAt": "2025-06-01T10:00:00.000Z",
  "updatedAt": "2025-06-01T10:00:00.000Z"
}

{
  "id": "cm3def456ghi789",
  "status": "PENDING",
  "platform": "INSTAGRAM",
  "text": "¡Próximamente!",
  "media": ["https://cdn.dopost.co/uploads/foto.jpg"],
  "postUrl": null,
  "account": {
    "id": "cm3jkl012mno345",
    "platform": "INSTAGRAM",
    "platformUsername": "janedoe"
  },
  "schedule": {
    "scheduledFor": "2025-12-25T12:00:00.000Z",
    "status": "SCHEDULED",
    "publishedAt": null
  },
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "source": "api",
  "createdAt": "2025-06-01T10:00:00.000Z",
  "updatedAt": "2025-06-01T10:00:00.000Z"
}

Plataformas soportadas

FacebookInstagramLinkedInXThreadsBlueskyMastodonPinterestTikTokYouTubeTelegramGoogle Business Profile

Respuestas de error

Estado	Error	Causa
401	`Invalid or missing API key`	Cabecera `x-api-key` incorrecta o ausente
403	`API key does not have permission for this action`	La API key no tiene el scope necesario para este endpoint
404	`Post not found`	`postId` inválido o pertenece a otro workspace
429	`Rate limit exceeded`	Demasiadas peticiones. Revisa las cabeceras `X-RateLimit-*` y reintenta tras el tiempo indicado

Campos adicionales de Google Business

Solo los posts GOOGLE_BUSINESS incluyen platformOptions (tipo, categoría, CTA, fechas y oferta), providerStatus, providerResourceName y error. El error es null o { message, code, retryable, requiresReconnect, details? }; los datos desconocidos conservan null. Los estados de Google son los últimos devueltos al publicar, no una comprobación en tiempo real. PUBLISHED en dopost no garantiza que Google ya lo haya hecho visible. El listado de posts incluye estos mismos campos. Las respuestas de otras redes conservan su formato.