Truth Social Profile
Truth Social 프로필 조회는 알고 있는 공개 계정을 확인합니다. 사용자 이름을 제출하면 정보 보강, 검토, 정기적인 프로필 스냅샷에 바로 쓸 수 있는 정규화된 계정 레코드 하나를 받습니다.
Truth Social Profile API 주요 기능
- 정확한 사용자 이름 조회유사 계정 검색이나 프로필 URL 없이, 작업당 알고 있는 공개 사용자 이름 하나를 조회합니다.
- 일관된 계정 식별 정보계정 ID, 사용자 이름, 표시 이름, 공개 프로필 URL, 소개글, 수집 시각을 고정된 필드로 받습니다.
- 프로필 상세 정보공개된 경우 아바타, 커버 이미지, 웹사이트, 위치, 인증 상태, 비공개 상태를 가져옵니다.
- 공개 수치 스냅샷수집 시점에 확인된 팔로워 수, 팔로잉 수, 게시물 수를 기록해 이후 비교에 활용합니다.
Truth Social Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈으로 이루어진 1~64자의 공개 사용자 이름으로, 필수 값입니다. 앞에 @ 하나는 검증을 통과하지만, @ 없는 정식 사용자 이름을 권장합니다. 프로필 URL은 허용되지 않습니다. |
Truth Social Profile API 사용 방법
공개 사용자 이름 하나를 제출하고 작업 ID를 저장한 뒤, 작업이 끝나면 계정 결과를 읽습니다.
- realDonaldTrump처럼 알고 있는 Truth Social 사용자 이름을 입력합니다. 정확한 조회를 위해 앞에 @를 붙이지 않은 사용자 이름을 사용하세요.
- username을 /v1/truth-social/profile로 POST하고, 응답의 data.task_id를 저장합니다.
- data.status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items에서 정규화된 계정 레코드를 읽습니다.
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-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 Profile API 추천 활용 사례
- 계정 정보 보강: 이미 사용자 이름이 있는 레코드에 공개 식별 정보, 소개글, 프로필 이미지, 웹사이트, 공개된 수치를 추가합니다.
- 계정 검토: 공개 프로필을 일관된 필드로 변환해 내부 검토, 분류, 수동 확인에 활용합니다.
- 프로필 변경 추적: 정기적으로 스냅샷을 저장하고 collected_at을 기준으로 소개글, 이미지, 상태, 수치를 비교합니다.
Truth Social Profile API 활용 팁
- 같은 계정이 여러 형태로 저장되지 않도록 @ 없는 정식 사용자 이름을 저장하세요.
- 문법이 올바르다고 해서 계정이 존재하거나, 공개 상태이거나, 지금 접근 가능하다는 보장은 없습니다.
- 프로필 이미지, 웹사이트, 위치, 상태, 수치는 원본에서 null일 수 있는 필드로 취급하세요.
- 이 엔드포인트는 계정 정보만 반환합니다. 공개 게시물은 Truth Social User Posts API를 사용하세요.
- results_limit이나 원본 커서를 보내지 마세요. 작업마다 계정 조회를 한 번만 수행합니다.
관련 API
Truth Social Profile API 외에 Truth Social의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Truth Social Post API — 알고 있는 Truth Social 게시물 URL 하나를 정규화된 콘텐츠, 작성자 맥락, 미디어, 타임스탬프, 확인 가능한 공개 참여도 필드로 변환합니다.
- Truth Social User Posts API — 사용자 이름 또는 숫자형 계정 ID로 공개 Truth Social 게시물의 원본 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.