bluesky/
profile

검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 조회하여 정규화된 계정 정보, 소개, 프로필 이미지, 웹사이트, 공개된 계정 수치를 비동기 작업 한 번으로 반환합니다.

Bluesky Profile API

검증된 사용자 이름 입력
프로필 정보와 이미지
공개된 계정 수치
요청당 0.19 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

검증된 사용자 이름 하나를 제출하고, 비동기 작업을 따라간 뒤, 표준 결과 응답에서 정규화된 프로필을 읽습니다.

  1. 영문자, 숫자, 점, 하이픈으로 이루어진 Bluesky 사용자 이름(예: jay.bsky.team)을 하나 준비하고, 앞의 @는 생략합니다.
  2. username을 /v1/bluesky/profile에 제출하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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.items

Bluesky 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 배열을 추가하지 마세요. 사용자 이름마다 고정 요금의 작업을 따로 제출하고, 정상 결과는 프로필 하나로 취급하세요.

Bluesky Profile API 외에 Bluesky의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Bluesky Post API — 알고 있는 공개 bsky.app 게시물 URL 하나를 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 태그, 멘션, 공개된 참여도 필드로 변환합니다.
  • Bluesky User Posts API — 핸들 또는 DID로 공개 Bluesky 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

Bluesky 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Bluesky Profile API — 자주 묻는 질문

Bluesky Profile API는 검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 가져오는 프로그래밍 인터페이스입니다. 정규화된 계정 정보, 소개, 프로필 이미지, 웹사이트, 선택적 상태 필드, 공개된 계정 수치, 수집 시각을 반환합니다.

앞에 @를 붙이지 않은 영문자, 숫자, 점, 하이픈 1~253자를 제출합니다. 밑줄, 콜론, 프로필 URL, DID, 빈 값, 추가 요청 필드는 거부됩니다.

표준 계정 레코드에는 식별·출처 필드, 사용자 이름, 표시 이름, 소개, 아바타, 커버, 웹사이트, 인증·비공개 값, 선택적 위치, 팔로워·팔로잉·게시물 수, 수집 시각이 포함됩니다. 확인할 수 없는 선택 필드는 null로 유지됩니다.

아니요. 작업마다 사용자 이름 하나를 받고 보통 프로필을 최대 1건 반환하며, results_limit이나 호출자가 제어하는 입력 커서는 없습니다. 다만 작업 결과는 표준 next_cursor와 has_more 구조를 그대로 사용합니다.

작업이 성공할 때마다 고정 0.19 SocQ 크레딧이 차감됩니다. 요청 한 번에 프로필 조회가 한 번만 수행되므로 요금은 결과 수에 따라 달라지지 않습니다.