Docs
Search docs...⌘K

Posts

API + MCP
GET/v3/social-media/posts

Requests to this endpoint are free and do not consume any API units.

Query parameters

statusstringRequired

The publishing lifecycle stage of the post.

Allowed values:publishedscheduleddraftfaileddeleted
channel_idsstring

Comma-separated list of channel IDs to filter by.

author_idsstring

Comma-separated list of author user IDs to filter by.

search_querystring

Text search query to filter posts by content.

date_fromstring (date)

The start date of the historical period in YYYY-MM-DD format.

date_tostring (date)

The end date of the historical period in YYYY-MM-DD format.

order_bystring

Sort field for posts. Metric-based sorting only applies to published posts.

Allowed values:dateviewsunique_viewscommentslikes
order_directionstring

The order in which results are returned, ascending or descending.

Allowed values:ascdesc
limitinteger

The number of results to return.

Default:50
offsetinteger

The number of results to skip.

Default:0
outputstring

The output format.

Allowed values:jsonphp

Responses

postsarray<object>
author_idstring or null

Unique identifier of the author.

author_namestring or null

Name of the author.

auto_commentstring or null

Auto-comment text posted after publishing.

channelsarray<object>

Social media channels associated with the post.

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring (url) or null
created_atstring (date-time)

Timestamp when the author created the post.

external_post_idstring or null

Platform-specific post identifier.

permalinkstring or null

URL of the published post on the platform.

post_idinteger

Unique identifier for the post.

status_timestampstring

Timestamp associated with the current status.

text_contentstring

Text content of the post.