Threads Profiles
Threads 프로필은 사용자 이름, 표시 이름, 소개, 프로필 이미지, 웹사이트, 공개된 팔로워·팔로잉·게시물 수를 담은 공개 계정 페이지입니다. 이러한 계정 정보와 계정 신호는 프로필 정보 보강, 공개 계정 비교, 시간 흐름에 따른 모니터링에 활용할 수 있습니다.
Threads Profiles API 주요 기능
- 지원되는 프로필 URL 일괄 처리/@username 경로를 사용하는 threads.com 또는 threads.net 프로필 URL을 하나 이상 처리하며, 게시물 링크와 관련 없는 경로는 거부합니다.
- 정규화된 프로필 정보프로필 ID, URL, 사용자 이름, 표시 이름, 소개, 프로필 이미지, 연결된 웹사이트를 일관된 프로필 레코드로 반환합니다.
- 공개된 계정 스냅샷제공되는 팔로워·팔로잉·게시물 수를 collected_at과 함께 보존하므로, 공개 수치 세트마다 관측 시각이 남습니다.
Threads Profiles API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | threads.com 또는 threads.net의 Threads 공개 프로필 URL 목록으로, 필수 값입니다. 각 경로는 /@username 형식이어야 하며, 사용자 이름만 입력한 값, 게시물 URL, 관련 없는 경로는 거부됩니다. |
Threads Profiles API 사용 방법
알고 있는 공개 프로필 URL을 제출하고, 비동기 작업을 따라가며, 정규화된 프로필 레코드를 커서 페이지네이션으로 읽습니다.
- threads.com 또는 threads.net의 /@username 경로를 사용하는 Threads 공개 프로필 URL을 하나 이상 준비합니다.
- 링크를 urls로 /v1/threads/profiles에 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/threads/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueThreads Profiles API 추천 활용 사례
- 공개 프로필 정보 보강: 알고 있는 Threads 프로필과 연결된 레코드에 사용자 이름, 표시 이름, 소개, 프로필 이미지, 웹사이트, 원본 URL을 추가합니다.
- 계정 규모 비교: 선택한 공개 프로필 그룹을 대상으로 공개된 팔로워·팔로잉·게시물 수를 비교합니다.
- 공개 프로필 모니터링: 계정 정보 필드와 공개된 수치를 collected_at과 함께 저장해, 수집 시점에 따른 프로필 구성과 계정 신호의 변화를 비교합니다.
Threads Profiles API 활용 팁
- 게시물 링크나 관련 없는 경로 때문에 요청이 실패하지 않도록, 제출하기 전에 각 URL이 threads.com 또는 threads.net의 /@username 경로인지 검증하세요.
- 제출하는 URL은 정규화하고, 반환된 프로필은 가능하면 id 기준으로 중복을 제거하세요. id가 없으면 url을 대체 고유 키로 사용합니다.
- 일부만 공개된 레코드도 쓸 수 있도록, 소개, 프로필 이미지, 웹사이트, 개별 계정 수치는 선택 필드로 처리하세요.
- 이후 실행 결과를 별개의 공개 스냅샷으로 구분할 수 있도록, 팔로워·팔로잉·게시물 수 옆에 collected_at을 함께 보관하세요.
관련 API
Threads Profiles API 외에 Threads의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Threads Posts API — 지원되는 Threads 게시물 URL에서 공개 게시물 텍스트, 작성자 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Threads User Posts API — Threads 프로필 URL에서 공개 게시물을 찾으며, 프로필별 결과 수 제한과 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도, 출처 맥락을 포함합니다.
- Threads Post Replies API — 게시물 URL로 Threads 게시물 아래의 답글을 수집하며 답글 텍스트, 작성자, 좋아요·답글 수, 미디어, 답글 대상 게시물 ID를 포함합니다.
- Threads Search API — 키워드나 해시태그로 Threads 상위 게시물을 검색하며 텍스트, 작성자, 좋아요, 답글, 리포스트, 미디어, 게시 시각을 포함합니다.
- Threads User Replies API — Threads 프로필 URL로 계정이 올린 최신 공개 답글을 수집하며 답글 텍스트, 참여 지표, 미디어, 링크를 포함합니다.
- Threads User Reposts API — Threads 프로필 URL로 계정이 최근 리포스트한 게시물을 수집하며, 각각 작성자, 텍스트, 참여 지표, 미디어가 담긴 원본 게시물로 반환합니다.