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

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