Skip to main content
GET
List posts on a platform

Authorizations

Authorization
string
header
required

Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.

Headers

Marky-Version
enum<string>

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Available options:
2026-04-08,
2026-07-17,
2026-08-02,
2026-08-04,
2026-08-06
Example:

"2026-08-06"

Path Parameters

business_id
string
required

A UUID identifier.

integration_id
string
required

A UUID identifier.

Query Parameters

since
string | null

Start date (ISO 8601 or Unix timestamp). Platform-dependent.

until
string | null

End date (ISO 8601 or Unix timestamp). Platform-dependent.

limit
integer
default:25

Max posts per page

Required range: 1 <= x <= 100
cursor
string | null

Pagination cursor. Pass the next_cursor from a previous response.

Response

Successful Response

Paginated response for post stats.

Used for both API responses and internal service communication.

posts
PostWithStats · object[]
required
next_cursor
string | null
total_count
integer | null
unavailable_reason
string | null