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

投稿

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

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

クエリパラメータ

offsetinteger

スキップする結果数。

デフォルト:0
limitinteger

返す結果数です。

デフォルト:50
order_directionstring

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

許可される値:ascdesc
order_bystring

投稿の並べ替えフィールド。指標に基づく並べ替えは公開済みの投稿にのみ適用されます。

許可される値:dateviewsunique_viewscommentslikes
date_tostring

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

date_fromstring

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

search_querystring

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

author_idsstring

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

channel_idsstring

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

statusstring必須

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

許可される値:publishedscheduleddraftfaileddeleted
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 or null
created_atstring

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

external_post_idstring or null

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

permalinkstring or null

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

post_idinteger

投稿の一意の識別子。

status_timestampstring

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

text_contentstring

投稿のテキスト内容。