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를 저장한 뒤, 작업이 끝나면 게시물 상세 정보를 읽습니다.
- 기본으로 제공되는 공개 게시물 URL을 사용하거나, 조회하려는 Truth Social 게시물의 전체 링크로 바꿉니다.
- url을 /v1/truth-social/post로 POST하고, 응답의 data.task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 successTruth Social Post API 추천 활용 사례
- 게시물 링크 정보 보강: 알고 있는 게시물 링크를 검색 가능한 텍스트, 작성자, 타임스탬프, 출처 필드로 변환합니다.
- 선택한 콘텐츠 검토: 검토 워크플로에서 특정 공개 게시물의 텍스트, 작성자, 첨부 파일을 가져옵니다.
- 참여도 변화 추적: 일정에 맞춰 조회를 반복하고, 공개된 참여도를 collected_at과 함께 비교합니다.
Truth Social Post API 활용 팁
- 프로필, 검색 페이지, 그 밖의 Truth Social 페이지가 아니라 실제 게시물의 전체 URL을 제출하세요.
- URL에는 http 또는 https가 포함되어야 하며 truthsocial.com 또는 그 하위 도메인을 사용해야 합니다.
- URL 검증을 통과했다고 해서 게시물이 존재하거나 계속 공개되어 있다는 보장은 없습니다.
- 작성자 정보, 미디어, 해시태그, 멘션, 참여도 데이터는 null일 수 있는 필드로 취급하세요.
- 이 엔드포인트는 results_limit이나 원본 커서를 받지 않으며, 작업당 게시물 레코드를 최대 1건 반환합니다.
관련 API
Truth Social Post API 외에 Truth Social의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Truth Social Profile API — 사용자 이름으로 공개 Truth Social 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 프로필 미디어, 계정 속성, 위치, 공개된 수치, 수집 맥락을 포함합니다.
- Truth Social User Posts API — 사용자 이름 또는 숫자형 계정 ID로 공개 Truth Social 게시물의 원본 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.