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

게시물의 텍스트 콘텐츠입니다.