Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.
사용할 수 있는 Truth Social API
사용자 이름 하나는 Profile, 사용자 이름 또는 숫자 계정 ID는 User Posts, 알고 있는 truthsocial.com 게시물 URL 하나는 Post를 사용합니다.
어떤 Truth Social 데이터를 가져올 수 있나요?
결과는 안정적인 계정·게시물 스키마를 따르며, 원본에 의존하는 필드는 null이 가능합니다.
프로필 식별 정보
제공되는 사용자 이름, 표시 이름, 소개글, 프로필 미디어, 웹사이트, 계정 플래그, 위치, 공개된 수치를 읽습니다.
게시물 콘텐츠
정규화된 게시물 식별 정보, 공개 URL, 텍스트, 작성자 정보, 게시 시각, 수집 시각을 가져옵니다.
미디어와 참여도
제공되는 첨부 파일, 해시태그, 멘션과 공개된 좋아요, 댓글, 공유, 조회 수를 활용합니다.
Truth Social API 선택하기
각 엔드포인트는 범위가 정해진 원본 입력을 받으며 같은 비동기 작업 흐름을 공유합니다.
| 엔드포인트 | 입력 | 원본 범위 |
|---|---|---|
| Profile | 사용자 이름 하나 | 공개 계정 하나 |
| User Posts | 사용자 이름 또는 숫자 사용자 ID | 데이터 제공자 응답 한 페이지 |
| Post | truthsocial.com URL 하나 | 공개 게시물 최대 1건 |
Truth Social 수집 방식
제출과 저장된 결과 읽기는 별도의 단계입니다.
1. 엔드포인트 선택
이미 알고 있는 공개 리소스에 맞춰 Profile, User Posts, Post 중에서 고릅니다.
2. 작업 추적
task_id를 저장하고 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 저장된 레코드 읽기
성공하면 data.results.items를 읽고, 저장된 결과에 다음 페이지가 있는 동안에만 next_cursor를 따라갑니다.
올바른 공개 식별자를 지정하고 SocQ API 키로 인증합니다.
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"}'Truth Social API 주요 활용 사례
공개 계정 정보 보강
알고 있는 공개 사용자 이름에 제공되는 식별 정보, 소개글, 이미지, 플래그, 수치를 연결합니다.
계정 게시물 스냅샷
선택한 계정에 노출된 게시물 레코드를 알려진 수집 시점과 함께 저장합니다.
알고 있는 게시물 검토
공개 게시물 하나를 제공되는 작성자, 미디어, 타임스탬프, 공개된 참여도와 함께 정규화합니다.
범위와 제한
이 엔드포인트는 수집 시점에 접근 가능한 공개 데이터를 읽으며, 계정 관리 기능은 제공하지 않습니다.
- Profile에는 @를 선택적으로 붙일 수 있는 형식의 사용자 이름 하나가 필요합니다.
- User Posts에는 username 또는 숫자로만 이루어진 user_id가 필요하며, 둘 다 보내면 두 값이 모두 전달됩니다. trim은 선택적인 불리언 값입니다.
- Post에는 파싱한 호스트 이름이 truthsocial.com 또는 그 하위 도메인인 비어 있지 않은 URL이 필요합니다.
- 이 요청들은 results_limit이나 데이터 제공자 커서를 받지 않습니다.
- 결과 커서와 limit은 SocQ에 이미 저장된 레코드를 페이지로 나눌 뿐, 원본의 다른 페이지를 가져오지 않습니다.
Truth Social API 자주 묻는 질문
어떤 Truth Social API를 사용할 수 있나요?
Profile은 공개 계정 하나를 가져오고, User Posts는 사용자 이름 또는 숫자 계정 ID의 원본 한 페이지를 수집하며, Post는 알고 있는 공개 게시물 URL 하나를 확인합니다.
User Posts에 username과 user_id를 함께 보낼 수 있나요?
네. 둘 중 하나는 필수이며, 백엔드는 비어 있지 않은 두 값을 모두 전달하고 어느 한쪽을 우선하지 않습니다.
next_cursor로 원본 게시물을 더 수집할 수 있나요?
아니요. 작업이 성공한 뒤 이미 저장된 레코드를 넘겨 볼 때만 사용합니다.
수집 요금은 어떻게 되나요?
성공한 Truth Social 작업은 건당 0.19 SocQ 크레딧의 고정 요금이 부과됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Google Ad Library API
공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.
Google Maps API
공개 장소를 찾고, 이미 알고 있는 Maps URL의 정규화된 상세 정보를 가져오고, 출처가 연결된 장소·작성자 정보와 함께 공개 리뷰를 수집합니다.
Amazon API
지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.
Apple App Store API
이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.
SEO API
실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.
Telegram API
t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.


