Docs
ドキュメントを検索...⌘K

投稿

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

このエンドポイントへのリクエストは無料で、APIユニットを消費しません。

クエリパラメータ

statusstring必須

投稿の公開ライフサイクルの段階。

許可される値:publishedscheduleddraftfaileddeleted
channel_idsstring

絞り込みに使用するチャンネル ID のカンマ区切りリスト。

author_idsstring

絞り込みに使用する投稿者ユーザー ID のカンマ区切りリスト。

search_querystring

投稿の内容で絞り込むためのテキスト検索クエリ。

date_fromstring (date)

履歴期間の開始日(YYYY-MM-DD形式)。

date_tostring (date)

履歴期間の終了日(YYYY-MM-DD形式)。

order_bystring

投稿の並べ替えに使用するフィールド。指標ベースの並べ替えは、公開済みの投稿にのみ適用されます。

許可される値:dateviewsunique_viewscommentslikes
order_directionstring

結果を返す順序(昇順または降順)。

許可される値:ascdesc
limitinteger

返す結果数です。

デフォルト:50
offsetinteger

スキップする結果の件数。

デフォルト:0
outputstring

出力形式。

許可される値:jsonphp

応答

postsarray<object>
author_idstring or null

投稿者の一意の識別子。

author_namestring or null

投稿者の名前。

auto_commentstring or null

公開後に投稿される自動コメントのテキスト。

channelsarray<object>

投稿に関連付けられているソーシャルメディアチャネル。

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

著者が投稿を作成した日時。

external_post_idstring or null

プラットフォーム固有の投稿識別子。

permalinkstring or null

プラットフォーム上で公開された投稿のURL。

post_idinteger

投稿の一意の識別子。

status_timestampstring

現在のステータスに関連付けられたタイムスタンプ。

text_contentstring

投稿のテキスト内容。