Bluesky 공개 데이터 API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.
사용할 수 있는 Bluesky API
계정 데이터는 Profiles, 알고 있는 공개 게시물 하나는 Posts, 핸들 또는 DID의 게시물 한 페이지는 User Posts를 사용합니다.
어떤 Bluesky 데이터를 가져올 수 있나요?
SocQ는 출처와 수집 시점 정보가 담긴 정규화된 공개 프로필·게시물 레코드를 반환합니다.
공개 프로필 상세
제공되는 계정 신원 정보, 소개, 프로필 이미지, 웹사이트, 계정 플래그, 공개된 수치, 수집 시각을 가져옵니다.
알고 있는 게시물의 콘텐츠
공개 bsky.app URL을 게시물 식별 정보, 텍스트, 작성자 정보, 미디어, 타임스탬프, 해시태그, 멘션으로 확인합니다.
선택한 계정의 게시물
@ 없는 핸들 또는 유효한 Bluesky DID로 공개 게시물의 원본 한 페이지를 수집합니다.
공개된 참여 수치
제공되는 좋아요, 댓글, 리포스트, 공유, 조회수를 특정 시점의 관측값으로 보관합니다.
SocQ vs Bluesky 직접 연동
SocQ는 비동기 방식의 정규화된 수집 워크플로를 제공합니다. 직접 연동하면 전송, 원본 객체, 저장, 결과 투영을 애플리케이션이 맡아야 합니다.
| 기능 | SocQ | 직접 연동 |
|---|---|---|
| 주요 용도 | 공개 프로필, 알고 있는 게시물, 계정 게시물 한 페이지 수집 | 제공자 고유의 읽기·쓰기 워크플로 구축 |
| 인증 | SocQ API 키 | 자격 증명은 고유 방식과 서비스에 따라 다름 |
| 시작 입력 | 엔드포인트에 따라 사용자 이름, 공개 게시물 URL, 핸들 또는 DID | 고유 식별자 또는 메서드별 매개변수 |
| 응답 형식 | 정규화된 SocQ 레코드 | 애플리케이션에서 직접 매핑해야 하는 제공자 고유 객체 |
Bluesky API 작동 방식
Profiles, Posts, User Posts는 같은 비동기 작업과 저장된 결과의 페이지네이션 워크플로를 사용합니다.
1. 지원되는 식별자 제출
사용자 이름, 게시물 URL, 핸들 또는 DID를 알맞은 API에 보내고 반환된 task_id를 저장합니다.
2. 작업 추적
처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 결과 가져오기
data.results.items를 읽고, 저장된 결과가 더 남아 있는 동안에만 next_cursor를 사용합니다.
SocQ API 키로 인증하고 공개 핸들을 User Posts에 제출합니다. Profiles와 Posts도 같은 작업 흐름을 따릅니다.
curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successBluesky API 주요 활용 사례
프로필 리서치
알고 있는 사용자 이름에 공개 신원 정보, 소개, 이미지, 웹사이트, 공개된 수치, 수집 시각을 추가합니다.
알고 있는 게시물 분석
선택한 게시물 URL을 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 참조, 참여도, 출처 필드로 변환합니다.
공개 계정 스냅샷
알고 있는 핸들 또는 DID의 게시물 한 페이지를 수집하고, 출처와 수집 타임스탬프를 함께 보관합니다.
참여도 비교
공개된 카운터를 특정 시점의 스냅샷으로 취급하면서, 반복 수집한 결과 간에 비교합니다.
제한 사항과 공개 데이터 정책
Bluesky 결과는 수집 시점에 사용할 수 있었던 공개 필드를 나타냅니다. 이 API들은 비공개 콘텐츠에 접근하지 않으며, 계정과 게시물을 게시·수정·삭제·관리하지 않습니다.
- Profiles에는 검증된 사용자 이름 하나가 필요하며 프로필 URL은 받지 않습니다.
- Posts는 파싱된 호스트 이름이 bsky.app 또는 bsky.app 서브도메인인 비어 있지 않은 참조 하나를 받습니다. 스킴이 있는 절대 참조와 프로토콜 상대 참조도 포함되며, 계정 피드나 답글 트리는 수집하지 않습니다.
- User Posts에는 username 또는 user_id가 필요합니다. 핸들에는 @를 붙이면 안 되고, user_id는 DID여야 합니다.
- User Posts는 results_limit이나 원본 커서를 받지 않으며 제공자 페이지 하나만 수집합니다.
- 작업 결과의 커서와 제한은 SocQ에 이미 저장된 레코드를 페이지 단위로 넘기는 것이며, 다른 원본 페이지를 수집하지 않습니다.
- 선택 항목인 신원, 콘텐츠, 미디어, 타임스탬프, 참조, 참여도 필드는 제공되지 않으면 비어 있을 수 있습니다.
Bluesky API 자주 묻는 질문
Bluesky API란 무엇인가요?
Bluesky API는 공개 프로필을 가져오고, 알고 있는 게시물을 확인하고, 핸들 또는 DID로 공개 계정 게시물 한 페이지를 수집합니다.
어떤 Bluesky API를 사용해야 하나요?
사용자 이름 기반 계정 레코드에는 Profiles, 알고 있는 bsky.app 게시물 URL 하나에는 Posts, 핸들 또는 DID의 게시물 한 페이지에는 User Posts를 사용하세요.
User Posts는 원본 커서를 따라가나요?
아니요. 제공자에 요청을 한 번만 보내 원본 한 페이지를 수집하며, next_cursor는 SocQ에 이미 저장된 결과 레코드만 넘겨 줍니다.
모든 필드와 지표가 항상 포함되나요?
아니요. 정규화된 구조는 안정적이지만, 원본에 따라 달라지는 신원, 콘텐츠, 미디어, 타임스탬프, 참조, 지표 값은 null일 수 있습니다.
Bluesky 수집 요금은 어떻게 되나요?
Profiles, Posts, User Posts 작업은 성공할 때마다 0.19 SocQ 크레딧이 고정으로 차감됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Snapchat API
알고 있는 공개 Snapchat Spotlight 하나를 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 참여도 필드가 포함된 정규화된 레코드로 가져옵니다.
Twitch API
알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.
Rednote API
공개 프로필과 노트를 가져오고, 노트나 사용자를 검색하고, 댓글과 중첩 답글을 수집하고, 홈 추천 페이지 하나를 가져옵니다.
Kwai API
공개 Kwai 프로필, 계정 게시물 한 페이지, 이미 알고 있는 게시물 하나를 정규화된 식별 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여도와 함께 가져옵니다.
Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.
Google Ad Library API
공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.


