v1

latestOpenAPI 3.0.32026-07-26737274.2 KB
Posts

List posts

Returns a cursor-paginated list of the account's posts — content published to the creator's Kit site and/or sent by email — with each post's status (e.g. draft, scheduled, published), slug, public_url, is_paid flag, and timestamps for publishing and sending.

Post bodies are omitted by default; set include_content=true to embed the content HTML on each post (this significantly increases response size and latency for large collections — prefer Get a post for a single body). A post that was also sent as a broadcast shares its publication_id with the matching broadcast from List broadcasts.

get/v4/posts

Query parameters

{"stackTrail":"paths:/v4/posts:get:parameters:0:schema","oasType":"schema","type":"unknown","nullable":true}

To fetch next page of results, use ?after=<end_cursor>

{"stackTrail":"paths:/v4/posts:get:parameters:1:schema","oasType":"schema","type":"unknown","nullable":true}

To fetch previous page of results, use ?before=<start_cursor>

include_contentboolean

To include the content field on each post in the response, use true. Omitted by default because it significantly increases response size and latency for large collections.

include_total_countboolean

Set to true to include the total_count in the response. This option can cause slow responses; if paging through results, request it only on the first page and reuse the value for subsequent pages.

{"stackTrail":"paths:/v4/posts:get:parameters:4:schema","oasType":"schema","type":"unknown","nullable":true}

Number of results per page. Default 500, maximum 1000.

Response

Returns a paginated list of all posts for your account