Posts

List posts

GEThttps://hivepost.app/v1/posts

Newest first. Test keys list test-mode posts; live keys list the workspace's posts.

Query

limitinteger
1 to 100. Default 20.
cursorstring
next_cursor from the previous page.
statusstring
One of draft, waiting, scheduled, publishing, live, failed, blocked

Returns

200 A page of posts.

Errors

Status	Code	When
401	`unauthorized`	No API key, or one that isn't valid (`unauthorized`).
403	`forbidden`, `drafts_only`, `network_not_available`	The key can't do this (`forbidden`, `drafts_only`), or the network isn't open in the API (`network_not_available`).
422	`validation_failed`, `return_url_not_allowed`, `account_not_connected`, `text_too_long`, `media_required`, `time_in_past`	A field is wrong (`validation_failed`), a connect link's `return_url` isn't on an allowed domain (`return_url_not_allowed`), an account needs reconnecting (`account_not_connected`), or a network refuses the post as it is (e.g. `text_too_long`, `media_required`, `time_in_past`). `details` lists each problem with the account it is about.
429	`rate_limited`	More than 60 requests in a minute (`rate_limited`).
500	`internal_error`	Something went wrong on our side (`internal_error`). Safe to retry with the same Idempotency-Key.

const res = await fetch("https://hivepost.app/v1/posts", { headers: { Authorization: `Bearer ${process.env.HIVEPOST_API_KEY}`, }, }); const data = await res.json(); console.log(res.status, data);

import os import requests res = requests.get( "https://hivepost.app/v1/posts", headers={ "Authorization": f"Bearer {os.environ['HIVEPOST_API_KEY']}", }, ) print(res.status_code, res.json())

{ "object": "list", "data": [ { "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21", "object": "post", "mode": "test", "status": "draft", "text": "Hello from the HivePost API", "publish_at": null, "brand_id": "0b6d2c1e-3f4a-4e5b-8c7d-9a1b2c3d4e5f", "accounts": [ { "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21", "network": "bluesky", "status": "draft", "text": null, "published_at": null, "external_id": null, "error": null } ], "media": [ { "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21", "status": "uploading" } ], "created_at": "2026-11-12T10:00:00Z" } ], "has_more": false, "next_cursor": null }