Sign in
posts

List your posts

Retrieve a paginated list of posts from your publication. The publication is identified by the API key provided in the Authorization header.

Use the status parameter to filter by post status (published, draft, scheduled, or archived). Defaults to published.

get/v1/posts

Query parameters

cursorstring

Cursor for pagination

limitinteger

Maximum number of items to return (1-100, default: 10)

boolean
OR
string

Include full content fields (markdown, json, staticHtml). Default: false

status'published' | 'draft' | 'scheduled' | 'archived'

Filter by post status. Default: published

Response

Posts retrieved successfully

Changes

Changed in 7 of the 61 revisions of this API.38

  • 8108f2a53d2e3See the full diff
    • ○

      added the optional property items/items/canonicalUrl to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property items/items/communityId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property items/items/publishOnline to the response with the 200 status

      response-optional-property-added

  • a38cc07e90d81See the full diff
    • ○

      added the optional property items/items/imageAlt to the response with the 200 status

      response-optional-property-added

  • 36c72d74820a1See the full diff
    • ●

      removed the optional property items/items/authors/items/farcaster from the response with the 200 status

      response-optional-property-removed

  • 90de04b871332See the full diff
    • ●

      removed the optional property error from the response with the 401 status

      response-optional-property-removed

    • ●

      removed the optional property error from the response with the 500 status

      response-optional-property-removed

  • b948146fe72f1See the full diff
    • ○

      added the optional property items/items/status to the response with the 200 status

      response-optional-property-added

  • c0bac868f6182See the full diff
    • ○

      query request parameter includeContent list-of-types was widened by adding types string

      request-parameter-list-of-types-widened

    • ○

      for the query request parameter includeContent, the type/format was generalized from boolean null/ to /

      request-parameter-type-generalized

  • 5b94722856861See the full diff
    • ○

      endpoint added

      endpoint-added