truth-social/
user-posts

공개 사용자 이름 또는 숫자 user_id를 입력하면 제공되는 계정 게시물을 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 참여도 데이터와 함께 조회합니다.

Truth Social User Posts API

사용자 이름 또는 user_id
공개 계정 게시물
작업당 0.19 크레딧
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Truth Social User Posts

Truth Social 사용자 게시물 조회는 알고 있는 공개 계정의 게시물을 가져옵니다. 작업마다 사용자 이름 또는 숫자 user_id로 계정을 식별해 수집 요청을 한 번 수행하고, 일관된 게시물 레코드를 반환합니다.

Truth Social User Posts API 주요 기능

  • 두 가지 계정 식별자공개 사용자 이름 또는 숫자로만 된 user_id를 사용합니다. 식별자는 하나 이상 필요합니다.
  • 작업당 한 번의 수집작업마다 계정 게시물 수집을 한 번 수행하며, 원본의 이후 페이지는 가져오지 않고 해당 응답에서 제공되는 공개 게시물을 반환합니다.
  • 정규화된 게시물 콘텐츠게시물 ID, URL, 텍스트, 작성자, 게시·수집 시각, 미디어, 해시태그, 멘션을 고정된 필드로 받습니다.
  • 공개된 참여도제공되는 좋아요 수, 댓글 수, 공유 수, 조회수를 보존하며, 제공되지 않는 값은 null로 유지합니다.

Truth Social User Posts API 매개변수

매개변수필수설명
username필수(하나 이상)앞에 @를 선택적으로 붙일 수 있고, 그 뒤에 ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈으로 이루어진 1~64자가 오는 공개 사용자 이름입니다. 앞뒤 공백과 프로필 URL은 허용되지 않습니다.
user_id필수(하나 이상)숫자로만 된 계정 ID입니다. username을 대신할 수 있으며, 일치하는 username과 함께 제출할 수도 있습니다.
trim선택선택 사항인 불리언 값입니다. 옵션을 명시적으로 설정해야 할 때 true 또는 false를 제출하고, 보내지 않으려면 이 필드를 생략하세요.

Truth Social User Posts API 사용 방법

사용자 이름 또는 user_id를 제공하고 작업 ID를 저장한 뒤, 작업이 성공하면 게시물 목록을 읽습니다.

  1. 공개 사용자 이름 또는 숫자로만 된 user_id를 입력합니다. 대부분의 경우 식별자는 하나만 제공하면 됩니다.
  2. 입력값을 /v1/truth-social/user-posts로 POST하고, 응답의 data.task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 읽습니다. 저장된 결과에서 has_more가 true일 때만 next_cursor를 따라가세요.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"realDonaldTrump"}'

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

Truth Social User Posts API 추천 활용 사례

  • 계정 콘텐츠 스냅샷: 현재 제공되는 공개 게시물을 보관, 검토, 정기 비교용으로 저장합니다.
  • 콘텐츠 분석: 일관된 텍스트, 작성자, 미디어, 타임스탬프 필드로 게시물을 분류, 검색, 처리합니다.
  • 참여도 관찰: 공개된 좋아요 수, 댓글 수, 공유 수, 조회수를 관찰 시각인 collected_at과 함께 비교합니다.

Truth Social User Posts API 활용 팁

  • 확인된 사용자 이름을 사용하는 것이 좋습니다. 다른 계정 결과에서 숫자 author.id를 얻었다면 user_id로 재사용할 수 있습니다.
  • username이나 user_id에 프로필 URL을 넣지 마세요.
  • 두 식별자를 모두 제공하면 두 값이 모두 전달되므로, 같은 계정을 가리키는지 확인하세요.
  • 이 엔드포인트는 results_limit이나 원본 커서를 받지 않으며, 작업마다 수집은 한 번만 이루어집니다.
  • next_cursor는 저장된 작업 결과 안에서만 이동하며, 원본의 게시물을 더 수집하지는 않습니다.

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

  • Truth Social Post API — 알고 있는 Truth Social 게시물 URL 하나를 정규화된 콘텐츠, 작성자 맥락, 미디어, 타임스탬프, 확인 가능한 공개 참여도 필드로 변환합니다.
  • Truth Social Profile API — 사용자 이름으로 공개 Truth Social 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 프로필 미디어, 계정 속성, 위치, 공개된 수치, 수집 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Truth Social User Posts API — 자주 묻는 질문

Truth Social User Posts API는 사용자 이름 또는 숫자 user_id로 공개 계정의 게시물을 조회하고, 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 공개된 참여도 데이터를 반환합니다.

둘 중 하나 이상이 필요합니다. 대부분의 경우 username을 사용하고, 계정의 숫자 ID를 이미 알고 있다면 user_id를 사용하세요.

네. 다만 두 값이 모두 수집에 전달되므로 같은 계정을 가리켜야 합니다.

trim은 선택 사항인 불리언 값입니다. true 또는 false를 명시적으로 선택해야 할 때만 설정하고, 그렇지 않으면 생략해도 됩니다.

아니요. 작업마다 원본 수집은 한 번만 이루어집니다. next_cursor는 해당 작업에 이미 저장된 레코드만 페이지로 넘깁니다.

작업이 성공할 때마다 반환된 게시물 수와 관계없이 0.19 크레딧이 고정으로 차감됩니다.