PublishQPublishQ

Get 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
/posts/{id}

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
Formatuuid

Response 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 everywhere 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
    }
  }
}

List posts GET

Returns a paginated list of the posts you created through PublishQ. Posts imported from a connected platform are excluded by default; pass includeImported=true to get both, or onlyImported=true for only the imported ones.

Create posts POST

Creates a post for one or more connected accounts.