API 목록으로 돌아가기
Threads 공개 데이터

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는 권한이 부여된 게시, 답글, 인사이트, 지원되는 탐색 워크플로를 위해 설계되었습니다.

기능SocQThreads API
주요 용도공개 프로필, 게시물, 사용자의 최근 게시물 수집권한이 부여된 게시, 답글, 인사이트, 탐색 연동 구축
고객 OAuthSocQ API 키만 사용하며 고객의 Threads OAuth 불필요Meta 앱, Threads 사용자 승인, 액세스 토큰
시작 입력공개 Threads 프로필 또는 게시물 URL권한이 부여된 계정 컨텍스트, Threads ID, 지원하는 검색 매개변수
답글 게시·관리지원하지 않음필요한 Threads 권한이 있으면 지원
응답 형식정규화된 SocQ 레코드Threads Graph API 고유 객체

Threads API 작동 방식

Profiles, Posts, User Posts 모두 같은 비동기 작업과 페이지네이션 결과 흐름을 따릅니다.

  1. 1. 공개 URL 제출

    프로필 또는 게시물 URL을 알맞은 API에 보내고 반환된 task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 가져오기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.

Threads 프로필의 게시물 수집

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 true

Threads 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 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.