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

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. 1. 지원되는 식별자 제출

    사용자 이름, 게시물 URL, 핸들 또는 DID를 알맞은 API에 보내고 반환된 task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 가져오기

    data.results.items를 읽고, 저장된 결과가 더 남아 있는 동안에만 next_cursor를 사용합니다.

Bluesky 핸들로 게시물 수집

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 success

Bluesky 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 크레딧이 고정으로 차감됩니다.

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