CLclipflow

List posts

get/v1/posts

Request

  • Base URL
    https://api.clipflow.co
  • Auth
    OAuth 2
    Authorization code: https://app.clipflow.co/oauth/authorize
    Token URL: https://app.clipflow.co/oauth/token scopes: posts.read

Query parameters

afterstring

Cursor: return results after this prefix_id (use meta.next_cursor from the previous page)

limitinteger
channel_idstring

Optional Channel prefix_id — only records linked to this channel

expandstring

Comma-separated serializer expansions. Expansions are opt-in — omit for the endpoint's default set, which is usually none. Allowed: channel, organization, platform_product, project

organization_idstring

Optional Organization prefix_id to narrow results

platform_keystring

Optional platform key from channel_products — only posts on this platform. Not combinable with platform_product_id or platform_product_key

platform_product_idstring

Optional PlatformProduct prefix_id — only posts of this product. Not combinable with platform_key or platform_product_key

platform_product_keystring

Optional platform product key from channel_products — only posts of this product. Not combinable with platform_key or platform_product_id

post_status'declined' | 'draft' | 'changes_required' | 'reviewed' | 'ready' | 'done' | 'failed'

Optional post status filter

scheduled_afterstring date-time

Optional ISO 8601 date-time with an explicit offset — only posts scheduled at or after it, e.g. 2026-11-01T00:00:00+10:00

scheduled_beforestring date-time

Optional ISO 8601 date-time with an explicit offset — only posts scheduled before it, e.g. 2026-11-08T00:00:00+10:00

tags[]string[]

Optional — only posts having any of these exact tags (case-insensitive)

titlestring

Optional title search (case-insensitive, partial match)

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.