Bluesky Profile
Bluesky 프로필은 고유 식별자, 핸들, 표시 이름, 소개, 프로필 이미지, 웹사이트, 공개된 팔로워·팔로잉·게시물 수를 담은 공개 계정 레코드입니다. 이러한 식별 정보와 계정 지표는 프로필 정보 보강, 공개 계정 비교, 시간에 따른 관찰에 활용할 수 있습니다.
Bluesky Profile API 주요 기능
- 사용자 이름 직접 조회영문자, 숫자, 점, 하이픈으로 이루어진 1~253자의 사용자 이름 하나를 공개 프로필 레코드로 변환합니다.
- 정규화된 프로필 식별 정보확인 가능한 프로필 ID, 원본 URL, 사용자 이름, 표시 이름, 소개, 연결된 웹사이트를 일관된 계정 구조로 반환합니다.
- 프로필 이미지와 상태 필드확인 가능한 아바타, 커버, 인증, 비공개 값을 null 허용 필드로 유지하며, 원본에 없는 값은 만들어 내지 않습니다.
- 공개된 계정 수치 스냅샷확인 가능한 팔로워·팔로잉·게시물 수를 collected_at과 함께 묶어, 공개 계정 스냅샷마다 관측 시각이 남도록 합니다.
Bluesky Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | 영문자, 숫자, 점, 하이픈으로 이루어진 1~253자의 공개 Bluesky 사용자 이름으로, 필수 값입니다. 앞의 @, 밑줄, DID, 프로필 URL, 두 번째 사용자 이름은 포함하지 마세요. |
Bluesky Profile API 사용 방법
검증된 사용자 이름 하나를 제출하고, 비동기 작업을 따라간 뒤, 표준 결과 응답에서 정규화된 프로필을 읽습니다.
- 영문자, 숫자, 점, 하이픈으로 이루어진 Bluesky 사용자 이름(예: jay.bsky.team)을 하나 준비하고, 앞의 @는 생략합니다.
- username을 /v1/bluesky/profile에 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. 이 조회는 보통 프로필 하나를 저장하므로 has_more는 false이며, 일반 결과 응답에서 더 많은 데이터가 있다고 보고되면 next_cursor로 이어서 요청합니다.
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read the profile from data.results.itemsBluesky Profile API 추천 활용 사례
- 알고 있는 프로필 정보 보강: Bluesky 사용자 이름이 이미 있는 레코드에 공개 핸들, 표시 이름, 소개, 프로필 이미지, 웹사이트, 원본 URL을 추가합니다.
- 계정 규모 비교: 따로 제출한 사용자 이름들의 팔로워·팔로잉·게시물 수를 같은 정규화된 지표 키로 비교합니다.
- 프로필 구성 모니터링: 반복 작업에서 식별 정보, 소개, 이미지, 웹사이트, collected_at을 저장해 공개 스냅샷 사이의 변화를 파악합니다.
Bluesky Profile API 활용 팁
- 앞의 @를 제거하고 나머지 사용자 이름이 영문자, 숫자, 점, 하이픈으로만 이루어졌는지 제출 전에 검증하세요. 이 엔드포인트는 user_id를 받지 않으므로 DID 값은 거부하세요.
- 중복 제거 키로는 반환된 id를 우선 사용하고, id가 비어 있으면 url 또는 username을 사용하세요.
- 일부만 공개된 레코드도 활용할 수 있도록 biography, avatar, cover, website, 상태 플래그, location, 개별 지표는 null을 허용하세요.
- results_limit이나 username 배열을 추가하지 마세요. 사용자 이름마다 고정 요금의 작업을 따로 제출하고, 정상 결과는 프로필 하나로 취급하세요.
관련 API
Bluesky Profile API 외에 Bluesky의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Bluesky Post API — 알고 있는 공개 bsky.app 게시물 URL 하나를 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 태그, 멘션, 공개된 참여도 필드로 변환합니다.
- Bluesky User Posts API — 핸들 또는 DID로 공개 Bluesky 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.