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 레코드를 읽습니다.
- 앞에 @가 없는 공개 Bluesky 핸들 또는 계정의 DID 중 하나를 선택합니다.
- 선택한 식별자를 /v1/bluesky/user-posts로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 succeedsBluesky User Posts API 추천 활용 사례
- 계정 콘텐츠 스냅샷: 알고 있는 핸들 또는 DID의 공개 게시물을 특정 시점의 한 페이지로 수집하고, 게시물 ID, 원본 URL, 게시 시각, 수집 시각을 보존합니다.
- 게시 패턴 조사: 정규화된 본문, 작성자, 해시태그, 멘션, 확인 가능한 미디어를 검토해 선택한 공개 계정의 주제와 형식을 파악합니다.
- 공개된 참여도 비교: 수집한 게시물의 좋아요, 댓글, 공유, 조회 수를 비교하며, 없는 지표는 0이 아니라 확인할 수 없는 값으로 취급합니다.
Bluesky User Posts API 활용 팁
- 핸들은 @ 없이 제출하고, 작업을 만들기 전에 영문자, 숫자, 마침표, 하이픈만 쓰였는지 검증하세요.
- 핸들이 바뀌어도 계정을 안정적으로 식별해야 한다면 전체 DID를 사용하고, 임의의 사용자 ID는 보내지 마세요.
- POST 페이로드에 results_limit이나 원본 커서를 추가하지 마세요. 공급자 수집은 1페이지 단위이므로 해당 필드는 거부됩니다.
- 작성자 정보, 미디어, 해시태그, 멘션, 개별 카운터는 선택 항목으로 취급하고, 반복 수집한 스냅샷은 게시물 id로 중복을 제거하세요.
관련 API
Bluesky User Posts API 외에 Bluesky의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Bluesky Profile API — 검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 이미지, 웹사이트, 상태 필드, 공개된 계정 수치, 수집 맥락을 포함합니다.
- Bluesky Post API — 알고 있는 공개 bsky.app 게시물 URL 하나를 정규화된 텍스트, 작성자, 미디어, 타임스탬프, 태그, 멘션, 공개된 참여도 필드로 변환합니다.