Threads 공개 데이터 API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.
사용할 수 있는 Threads API
계정 데이터는 Profiles, 알고 있는 공개 게시물 하나는 Posts, 선택한 프로필에서 범위를 정해 수집할 때는 User Posts를 사용합니다.
어떤 Threads 데이터를 가져올 수 있나요?
SocQ는 식별 정보, 콘텐츠, 미디어, 공개된 참여도, 출처, 수집 시점 정보가 담긴 정규화된 공개 계정·게시물 레코드를 반환합니다.
공개 프로필 상세
프로필 ID, URL, 사용자 이름, 표시 이름, 소개글, 이미지, 연결된 웹사이트, 공개된 계정 수치, 수집 시각을 가져옵니다.
알고 있는 게시물 콘텐츠
공개 게시물 URL을 게시물 식별 정보, 텍스트, 작성자 정보, 출처 URL, 제공되는 미디어로 변환합니다.
공개된 게시물 참여도
게시 시각과 수집 시각을 제공되는 좋아요, 댓글, 리포스트, 공유 수와 함께 보존합니다.
선택한 프로필의 게시물
프로필 URL마다 공개 게시물을 범위를 정해 둘러보고, 제출한 프로필과 결과를 연결된 상태로 유지합니다.
SocQ vs Threads API
SocQ는 지원하는 공개 Threads 데이터 수집에 집중합니다. Meta의 Threads API는 권한이 부여된 게시, 답글, 인사이트, 지원되는 탐색 워크플로를 위해 설계되었습니다.
| 기능 | SocQ | Threads API |
|---|---|---|
| 주요 용도 | 공개 프로필, 게시물, 사용자의 최근 게시물 수집 | 권한이 부여된 게시, 답글, 인사이트, 탐색 연동 구축 |
| 고객 OAuth | SocQ API 키만 사용하며 고객의 Threads OAuth 불필요 | Meta 앱, Threads 사용자 승인, 액세스 토큰 |
| 시작 입력 | 공개 Threads 프로필 또는 게시물 URL | 권한이 부여된 계정 컨텍스트, Threads ID, 지원하는 검색 매개변수 |
| 답글 게시·관리 | 지원하지 않음 | 필요한 Threads 권한이 있으면 지원 |
| 응답 형식 | 정규화된 SocQ 레코드 | Threads Graph API 고유 객체 |
Threads API 작동 방식
Profiles, Posts, User Posts 모두 같은 비동기 작업과 페이지네이션 결과 흐름을 따릅니다.
1. 공개 URL 제출
프로필 또는 게시물 URL을 알맞은 API에 보내고 반환된 task_id를 저장합니다.
2. 작업 추적
처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 결과 가져오기
data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.
SocQ API 키로 인증하고 공개 프로필 URL을 User Posts에 제출합니다. Profiles와 Posts도 같은 작업 흐름을 따릅니다.
curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueThreads API 주요 활용 사례
크리에이터·프로필 리서치
알고 있는 프로필 URL에 공개 식별 정보, 소개글, 웹사이트, 공개된 계정 지표, 수집 시각을 추가합니다.
알고 있는 게시물 분석
선택한 게시물 URL을 콘텐츠, 작성자, 미디어, 게시 시각, 공개된 참여도, 출처 필드로 변환합니다.
크리에이터 콘텐츠 모니터링
선택한 프로필에서 범위를 정해 게시물을 수집하고, 반복 수집한 결과 간 콘텐츠를 비교합니다.
참여도 리포팅
공개된 수치와 collected_at으로 공개 게시물 스냅샷을 비교하며, 실시간 지표로 취급하지 않습니다.
제한 사항과 공개 데이터 정책
Threads 결과는 특정 시점의 공개 레코드입니다. 이 API들은 비공개 콘텐츠에 접근하지 않으며, Threads 계정과 게시물을 게시·수정·삭제·관리하지 않습니다.
- Profiles는 threads.com과 threads.net의 /@username URL을 받습니다. 사용자 이름만 보내거나 게시물 URL을 보내면 거부됩니다.
- Posts는 /@username/post/{post_id} URL을 받습니다. results_limit이나 프로필 게시물 탐색은 지원하지 않습니다.
- User Posts는 /@username 프로필 URL을 받습니다. results_limit의 기본값은 100이고 1~2,000을 받으며, 프로필마다 따로 적용됩니다.
- User Posts는 결과가 원본 게시물인지, 답글, 인용, 리포스트인지 구분하지 않습니다.
- 게시물에 comments_count가 포함될 수 있지만 개별 답글과 답글 트리는 반환하지 않습니다.
- 공개 레코드에서 노출하지 않는 경우 선택 항목인 식별 정보, 콘텐츠, 미디어, 타임스탬프, 참여도 필드는 비어 있을 수 있습니다.
Threads API 자주 묻는 질문
Threads API란 무엇인가요?
Threads API는 공개 프로필 데이터를 가져오고, 알고 있는 게시물을 확인하고, 선택한 프로필의 게시물을 범위를 정해 수집하는 SocQ 엔드포인트 모음입니다.
어떤 Threads API를 사용해야 하나요?
/@username 계정 레코드는 Profiles, 정확한 /@username/post/{post_id} 링크는 Posts, 각 /@username 프로필 URL에서 범위를 정해 수집할 때는 User Posts를 사용하세요.
User Posts의 결과 상한은 어떻게 적용되나요?
results_limit의 기본값은 100이고 1부터 2,000까지의 정수를 받으며, 제출한 프로필 URL마다 따로 적용됩니다.
User Posts 결과에서 답글이나 리포스트를 구분할 수 있나요?
정규화된 결과에는 게시물 하위 유형이 포함되지 않습니다. 각 항목은 제출한 프로필에서 찾은 공개 게시물로 취급하고, 원본 게시물인지 답글, 인용, 리포스트인지는 추측하지 마세요.
Threads 게시물과 참여도 지표는 완전하거나 실시간인가요?
아니요. 결과는 수집 시점에 제공되는 공개 필드를 반영하며 전체 답글 트리는 포함하지 않으므로, 실시간 피드가 아니라 특정 시점의 스냅샷으로 취급하세요.
Threads 수집 요금은 어떻게 되나요?
반환된 프로필은 1건당 0.6 크레딧, Posts나 User Posts에서 반환된 게시물은 1건당 0.5 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Bluesky API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.
Snapchat API
알고 있는 공개 Snapchat Spotlight 하나를 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 참여도 필드가 포함된 정규화된 레코드로 가져옵니다.
Twitch API
알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.
Rednote API
공개 프로필과 노트를 가져오고, 노트나 사용자를 검색하고, 댓글과 중첩 답글을 수집하고, 홈 추천 페이지 하나를 가져옵니다.
Kwai API
공개 Kwai 프로필, 계정 게시물 한 페이지, 이미 알고 있는 게시물 하나를 정규화된 식별 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여도와 함께 가져옵니다.
Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.







