PublishQGet post
Get one post by its PublishQ post ID. Returns the post details and the connected account metadata needed to identify where it belongs.
Get one post by its PublishQ post ID. Returns the post details and the connected account metadata needed to identify where it belongs.
Authorization
ApiKeyAuth AuthorizationBearer <token>
PublishQ API key sent as Authorization: Bearer pq_live_....
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://publishq.com/api/v1/posts/1b5c779b-d7de-4e4e-bf55-95b9317b6d93"{
"id": "9f8e7d6c-5b4a-3210-fedc-ba0987654321",
"content": "Just shipped our new API — schedule posts to 8 platforms with one call 🚀",
"status": "PUBLISHED",
"mediaIds": [
"d4c3b2a1-0987-6543-21fe-dcba09876543"
],
"publishedAt": "2026-04-01T12:01:23Z",
"createdAt": "2026-03-30T10:00:00Z",
"accounts": [
{
"accountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"platform": "TWITTER",
"accountName": "@publishq",
"status": "PUBLISHED",
"externalUrl": "https://x.com/publishq/status/1234567890",
"publishedAt": "2026-04-01T12:01:05Z"
},
{
"accountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"platform": "LINKEDIN",
"accountName": "PublishQ Inc.",
"status": "PUBLISHED",
"externalUrl": "https://www.linkedin.com/feed/update/urn:li:share:7654321",
"publishedAt": "2026-04-01T12:01:23Z"
}
]
}{
"error": {
"title": "Unauthorized",
"status": 401,
"code": "missing_auth",
"message": "Missing Authorization header",
"instance": "/api/v1/posts"
}
}{
"error": {
"title": "Not Found",
"status": 404,
"code": "post_not_found",
"message": "Post not found",
"instance": "/api/v1/posts"
}
}{
"error": {
"title": "Too Many Requests",
"status": 429,
"code": "rate_limit_exceeded",
"message": "Too Many Requests",
"instance": "/api/v1/posts/1b5c779b-d7de-4e4e-bf55-95b9317b6d93",
"details": {
"retryAfter": 60
}
}
}