bluesky/
user-posts

핸들 또는 DID로 공개 Bluesky 게시물 한 페이지를 수집하여 정규화된 본문, 작성자 정보, 타임스탬프, 참여 지표, 확인 가능한 미디어를 제공합니다.

Bluesky User Posts API

핸들 또는 DID 입력
원본 1페이지
정규화된 게시물 레코드
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Bluesky User Posts

Bluesky User Posts는 핸들 또는 분산 식별자(DID)로 지정한 계정 하나에서 수집한 공개 게시물입니다. 정규화된 각 레코드에는 게시물 본문, 작성자 정보, 원본·수집 시각, 공개 미디어, 해시태그, 멘션, 확인 가능한 참여 지표를 담을 수 있습니다.

Bluesky User Posts API 주요 기능

  • 두 가지 계정 식별자jay.bsky.team 같은 Bluesky 핸들 또는 did:method:identifier 형식의 DID 중 정확히 하나만 제출합니다.
  • 1페이지 단위 계정 수집선택한 계정에 대해 공급자 요청을 한 번 보내고, 호출자가 제어하는 원본 커서나 결과 한도 없이 해당 원본 페이지에 노출된 공개 게시물을 수집합니다.
  • 일관된 게시물 형태의 결과공급자 응답 구조에 의존하지 않고 정규화된 게시물 식별 정보, 본문, 작성자, 타임스탬프, 지표, 미디어, 해시태그, 멘션을 읽습니다.

Bluesky User Posts API 매개변수

매개변수필수설명
username필수(하나 이상)영문자, 숫자, 마침표, 하이픈으로 이루어진 1~253자의 공개 Bluesky 핸들입니다. 앞의 @는 허용되지 않으며, user_id를 대신 제공하는 경우에는 이 필드를 생략하세요.
user_id필수(하나 이상)did:로 시작하고, 소문자 메서드와 비어 있지 않은 식별자가 이어지는 Bluesky 분산 식별자입니다. 식별자에는 지원되는 영문자, 숫자, 마침표, 밑줄, 콜론, 퍼센트 기호, 하이픈을 사용할 수 있습니다.

Bluesky User Posts API 사용 방법

Bluesky 핸들 또는 DID를 제출하고, 비동기 작업을 추적한 뒤, 완료 후 저장된 PostItem 레코드를 읽습니다.

  1. 앞에 @가 없는 공개 Bluesky 핸들 또는 계정의 DID 중 하나를 선택합니다.
  2. 선택한 식별자를 /v1/bluesky/user-posts로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, 저장된 결과에 다음 페이지가 있을 때만 작업 응답의 next_cursor를 사용합니다.
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 the task succeeds

Bluesky User Posts API 추천 활용 사례

  • 계정 콘텐츠 스냅샷: 알고 있는 핸들 또는 DID의 공개 게시물을 특정 시점의 한 페이지로 수집하고, 게시물 ID, 원본 URL, 게시 시각, 수집 시각을 보존합니다.
  • 게시 패턴 조사: 정규화된 본문, 작성자, 해시태그, 멘션, 확인 가능한 미디어를 검토해 선택한 공개 계정의 주제와 형식을 파악합니다.
  • 공개된 참여도 비교: 수집한 게시물의 좋아요, 댓글, 공유, 조회 수를 비교하며, 없는 지표는 0이 아니라 확인할 수 없는 값으로 취급합니다.

Bluesky User Posts API 활용 팁

  • 핸들은 @ 없이 제출하고, 작업을 만들기 전에 영문자, 숫자, 마침표, 하이픈만 쓰였는지 검증하세요.
  • 핸들이 바뀌어도 계정을 안정적으로 식별해야 한다면 전체 DID를 사용하고, 임의의 사용자 ID는 보내지 마세요.
  • POST 페이로드에 results_limit이나 원본 커서를 추가하지 마세요. 공급자 수집은 1페이지 단위이므로 해당 필드는 거부됩니다.
  • 작성자 정보, 미디어, 해시태그, 멘션, 개별 카운터는 선택 항목으로 취급하고, 반복 수집한 스냅샷은 게시물 id로 중복을 제거하세요.

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

  • Bluesky Profile API — 검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 이미지, 웹사이트, 상태 필드, 공개된 계정 수치, 수집 맥락을 포함합니다.
  • Bluesky Post API — 알고 있는 공개 bsky.app 게시물 URL 하나를 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 태그, 멘션, 공개된 참여도 필드로 변환합니다.

다른 플랫폼 둘러보기

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

Bluesky User Posts API — 자주 묻는 질문

Bluesky User Posts API는 Bluesky 핸들 또는 DID로 계정의 공개 게시물 한 페이지를 가져와, 정규화된 게시물 본문, 작성자, 미디어, 타임스탬프, 공개된 참여 데이터를 반환하는 인터페이스입니다.

정확히 하나만 보내세요. username은 @ 없는 공개 핸들이고, user_id는 유효한 DID여야 합니다. 두 필드를 모두 보내면 검증 오류가 반환됩니다.

아니요. 제출 사양은 username과 user_id만 받으며, 공급자 실행은 공급자 커서를 따라가지 않고 원본 1페이지만 수집합니다.

작업 엔드포인트는 SocQ에 이미 저장된 레코드를 페이지네이션하며 1~500 범위의 조회 한도를 받습니다. 저장된 결과용 커서이므로 Bluesky 공급자의 다른 페이지를 요청하지 않습니다.

PostItem 스키마에는 식별 정보, 플랫폼·리소스 라벨, URL, 게시·수집 시각, 본문, 작성자, 지표, 미디어, 해시태그, 멘션이 포함됩니다. 원본에 따라 달라지는 필드는 null일 수 있습니다.

작업이 성공하면 고정 0.19 SocQ 크레딧이 차감됩니다. 원본 페이지에서 저장된 게시물 수에 따라 요금이 달라지지 않습니다.