Skip to main content
GET
List posts

Authorizations

Authorization
string
header
required

An API key from Settings, API & MCP: pm_live_...

Query Parameters

status
enum<string>

all when left out.

Available options:
all,
scheduled,
sent,
failed,
cancelled
platform
enum<string>

A network PostMesh posts to.

Available options:
twitter,
youtube,
instagram,
tiktok,
threads,
facebook,
linkedin,
reddit,
bluesky,
mastodon,
telegram,
discord
label
string<uuid>

Only posts with this label.

q
string

Words in the caption.

Maximum string length: 200
from
string

Start of a window, a date or date-time, inclusive.

Maximum string length: 64
to
string

End of the window, exclusive. At most 366 days after from.

Maximum string length: 64
limit
integer

1 to 50, 20 when left out.

Required range: 1 <= x <= 50
cursor
string

next_cursor from the page before.

Maximum string length: 512
count
enum<string>

true counts every post the filters match (first page only).

Available options:
true,
false

Response

A page of posts.

data
object[]
required
next_cursor
string | null
required
total
integer
Required range: -9007199254740991 <= x <= 9007199254740991