truth-social/
post

공개 Truth Social 게시물 URL 하나를 입력하면 정규화된 텍스트, 작성자, 미디어, 게시 시각, 공개된 참여도 데이터를 조회합니다.

Truth Social Post API

게시물 URL
단일 게시물 상세 정보
작업당 0.19 크레딧
요청당 0.19 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Truth Social Post

Truth Social 게시물 조회는 알고 있는 공개 게시물 하나를 확인합니다. 게시물 URL을 제출하면 링크 정보 보강, 콘텐츠 검토, 정기적인 참여도 스냅샷에 쓸 수 있는 정규화된 레코드를 최대 1건 받습니다.

Truth Social Post API 주요 기능

  • 정확한 URL 조회키워드 검색 없이 작업당 공개 truthsocial.com 게시물 URL 하나를 제출합니다.
  • 완전한 게시물 콘텐츠게시물 ID, 공개 URL, 텍스트, 게시 시각, 수집 시각을 받습니다.
  • 작성자 및 미디어 정보확인 가능한 작성자 식별 정보, 아바타, 계정 상태, 미디어, 해시태그, 멘션을 그대로 보존합니다.
  • 참여도 스냅샷공개된 좋아요 수, 댓글 수, 공유 수, 조회수를 기록하며, 제공되지 않는 값은 null로 유지합니다.

Truth Social Post API 매개변수

매개변수필수설명
url필수공개 Truth Social 게시물의 전체 URL로, 필수 값입니다. 파싱한 호스트 이름은 truthsocial.com 또는 그 하위 도메인이어야 합니다. http 또는 https를 포함하고 실제 게시물 경로를 제출하세요.

Truth Social Post API 사용 방법

실제 공개 게시물 URL을 제출하고 작업 ID를 저장한 뒤, 작업이 끝나면 게시물 상세 정보를 읽습니다.

  1. 기본으로 제공되는 공개 게시물 URL을 사용하거나, 조회하려는 Truth Social 게시물의 전체 링크로 바꿉니다.
  2. url을 /v1/truth-social/post로 POST하고, 응답의 data.task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items에서 정규화된 게시물 레코드를 읽습니다.
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Truth Social Post API 추천 활용 사례

  • 게시물 링크 정보 보강: 알고 있는 게시물 링크를 검색 가능한 텍스트, 작성자, 타임스탬프, 출처 필드로 변환합니다.
  • 선택한 콘텐츠 검토: 검토 워크플로에서 특정 공개 게시물의 텍스트, 작성자, 첨부 파일을 가져옵니다.
  • 참여도 변화 추적: 일정에 맞춰 조회를 반복하고, 공개된 참여도를 collected_at과 함께 비교합니다.

Truth Social Post API 활용 팁

  • 프로필, 검색 페이지, 그 밖의 Truth Social 페이지가 아니라 실제 게시물의 전체 URL을 제출하세요.
  • URL에는 http 또는 https가 포함되어야 하며 truthsocial.com 또는 그 하위 도메인을 사용해야 합니다.
  • URL 검증을 통과했다고 해서 게시물이 존재하거나 계속 공개되어 있다는 보장은 없습니다.
  • 작성자 정보, 미디어, 해시태그, 멘션, 참여도 데이터는 null일 수 있는 필드로 취급하세요.
  • 이 엔드포인트는 results_limit이나 원본 커서를 받지 않으며, 작업당 게시물 레코드를 최대 1건 반환합니다.

Truth Social Post API 외에 Truth Social의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Truth Social Profile API — 사용자 이름으로 공개 Truth Social 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 프로필 미디어, 계정 속성, 위치, 공개된 수치, 수집 맥락을 포함합니다.
  • Truth Social User Posts API — 사용자 이름 또는 숫자형 계정 ID로 공개 Truth Social 게시물의 원본 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

Truth Social 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Truth Social Post API — 자주 묻는 질문

Truth Social Post API는 공개 게시물 URL에서 텍스트, 작성자, 미디어, 게시 시각, 공개된 참여도 데이터를 포함한 정규화된 게시물 상세 정보를 조회합니다.

http 또는 https를 포함한 공개 게시물의 전체 URL을 제출합니다. 호스트 이름은 truthsocial.com 또는 그 하위 도메인이어야 합니다.

권장하지 않습니다. 이 엔드포인트는 특정 게시물을 조회하므로 실제 게시물 경로를 사용하세요. 같은 도메인의 다른 페이지는 호스트 이름 검증을 통과하더라도 결과가 반환되지 않을 수 있습니다.

최대 1개입니다. 작업마다 제출한 URL이 가리키는 게시물을 조회합니다.

작성자 정보, 미디어, 해시태그, 멘션, 참여도 수치가 공개되지 않았거나 원본 응답에 없을 수 있습니다.

작업이 성공할 때마다 값이 채워진 필드 수와 관계없이 0.19 크레딧이 고정으로 차감됩니다.