truth-social/
profile

공개 Truth Social 사용자 이름 하나를 입력하면 정규화된 계정 정보, 소개글, 프로필 이미지, 계정 상태, 공개된 수치를 조회합니다.

Truth Social Profile API

사용자 이름 조회
계정 프로필
작업당 0.19 크레딧
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 저장한 뒤, 작업이 끝나면 계정 결과를 읽습니다.

  1. realDonaldTrump처럼 알고 있는 Truth Social 사용자 이름을 입력합니다. 정확한 조회를 위해 앞에 @를 붙이지 않은 사용자 이름을 사용하세요.
  2. username을 /v1/truth-social/profile로 POST하고, 응답의 data.task_id를 저장합니다.
  3. data.status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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 success

Truth Social Profile API 추천 활용 사례

  • 계정 정보 보강: 이미 사용자 이름이 있는 레코드에 공개 식별 정보, 소개글, 프로필 이미지, 웹사이트, 공개된 수치를 추가합니다.
  • 계정 검토: 공개 프로필을 일관된 필드로 변환해 내부 검토, 분류, 수동 확인에 활용합니다.
  • 프로필 변경 추적: 정기적으로 스냅샷을 저장하고 collected_at을 기준으로 소개글, 이미지, 상태, 수치를 비교합니다.

Truth Social Profile API 활용 팁

  • 같은 계정이 여러 형태로 저장되지 않도록 @ 없는 정식 사용자 이름을 저장하세요.
  • 문법이 올바르다고 해서 계정이 존재하거나, 공개 상태이거나, 지금 접근 가능하다는 보장은 없습니다.
  • 프로필 이미지, 웹사이트, 위치, 상태, 수치는 원본에서 null일 수 있는 필드로 취급하세요.
  • 이 엔드포인트는 계정 정보만 반환합니다. 공개 게시물은 Truth Social User Posts API를 사용하세요.
  • results_limit이나 원본 커서를 보내지 마세요. 작업마다 계정 조회를 한 번만 수행합니다.

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

  • Truth Social Post API — 알고 있는 Truth Social 게시물 URL 하나를 정규화된 콘텐츠, 작성자 맥락, 미디어, 타임스탬프, 확인 가능한 공개 참여도 필드로 변환합니다.
  • Truth Social User Posts API — 사용자 이름 또는 숫자형 계정 ID로 공개 Truth Social 게시물의 원본 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

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

Truth Social Profile API — 자주 묻는 질문

Truth Social Profile API는 사용자 이름으로 계정 식별 정보, 소개글, 프로필 이미지, 계정 상태, 공개된 수치를 포함한 정규화된 공개 계정 레코드를 조회합니다.

realDonaldTrump처럼 @ 없는 공개 사용자 이름을 사용하세요. ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈을 포함할 수 있으며 최대 길이는 64자입니다.

결과에는 계정 ID, 사용자 이름, 표시 이름, 프로필 URL, 소개글, 아바타, 커버, 웹사이트, 위치, 인증·비공개 상태, 팔로워 수·팔로잉 수·게시물 수가 포함될 수 있습니다.

검증은 사용자 이름 형식만 확인합니다. 계정이 존재하지 않거나, 비공개이거나, 수집 시점에 공개적으로 접근할 수 없을 수 있습니다.

아니요. 프로필 데이터만 반환합니다. 공개 게시물은 Truth Social User Posts API로 가져오세요.

작업이 성공할 때마다 0.19 크레딧이 고정으로 차감됩니다. 실패한 작업에는 환불 정책이 적용됩니다.