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를 저장한 뒤, 작업이 성공하면 게시물 목록을 읽습니다.
- 공개 사용자 이름 또는 숫자로만 된 user_id를 입력합니다. 대부분의 경우 식별자는 하나만 제공하면 됩니다.
- 입력값을 /v1/truth-social/user-posts로 POST하고, 응답의 data.task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 successTruth Social User Posts API 추천 활용 사례
- 계정 콘텐츠 스냅샷: 현재 제공되는 공개 게시물을 보관, 검토, 정기 비교용으로 저장합니다.
- 콘텐츠 분석: 일관된 텍스트, 작성자, 미디어, 타임스탬프 필드로 게시물을 분류, 검색, 처리합니다.
- 참여도 관찰: 공개된 좋아요 수, 댓글 수, 공유 수, 조회수를 관찰 시각인 collected_at과 함께 비교합니다.
Truth Social User Posts API 활용 팁
- 확인된 사용자 이름을 사용하는 것이 좋습니다. 다른 계정 결과에서 숫자 author.id를 얻었다면 user_id로 재사용할 수 있습니다.
- username이나 user_id에 프로필 URL을 넣지 마세요.
- 두 식별자를 모두 제공하면 두 값이 모두 전달되므로, 같은 계정을 가리키는지 확인하세요.
- 이 엔드포인트는 results_limit이나 원본 커서를 받지 않으며, 작업마다 수집은 한 번만 이루어집니다.
- next_cursor는 저장된 작업 결과 안에서만 이동하며, 원본의 게시물을 더 수집하지는 않습니다.
관련 API
Truth Social User Posts API 외에 Truth Social의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Truth Social Post API — 알고 있는 Truth Social 게시물 URL 하나를 정규화된 콘텐츠, 작성자 맥락, 미디어, 타임스탬프, 확인 가능한 공개 참여도 필드로 변환합니다.
- Truth Social Profile API — 사용자 이름으로 공개 Truth Social 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 프로필 미디어, 계정 속성, 위치, 공개된 수치, 수집 맥락을 포함합니다.