Bluesky Post
Bluesky 게시물은 본문, 작성자 정보, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여 수치를 갖춘 공개 콘텐츠입니다. 이러한 레코드는 URL 정보 보강, 출처 검토, 콘텐츠 조사, 시각이 기록된 참여도 비교에 활용할 수 있습니다.
Bluesky Post API 주요 기능
- 알고 있는 게시물 조회공개 bsky.app URL 하나를 계정 피드로 확장하지 않고, 선택한 게시물의 정규화된 레코드로 변환합니다.
- 콘텐츠와 작성자 정보확인 가능한 게시물 본문, 원본 URL, 작성자 정보, 첨부 미디어, 해시태그, 멘션, 게시 시각을 함께 반환합니다.
- 공개된 참여도 스냅샷확인 가능한 좋아요, 댓글, 리포스트, 조회 수를 수집 시각과 함께 유지해 특정 시점의 관측값으로 남깁니다.
Bluesky Post API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 비어 있지 않은 게시물 참조(URL)의 필수 값으로, 파싱된 호스트 이름은 bsky.app 또는 bsky.app 서브도메인이어야 합니다. 제출 검증기는 모든 스킴의 절대 URL과 프로토콜 상대 참조를 허용합니다. |
Bluesky Post API 사용 방법
알고 있는 공개 Bluesky 게시물 URL을 제출하고, 비동기 작업을 따라간 뒤, 표준 결과 구조에서 정규화된 결과를 읽습니다.
- 확인하려는 Bluesky 게시물로 연결되는 공개 bsky.app URL을 하나 준비합니다.
- URL을 url로 /v1/bluesky/post에 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, 결과 구조에서 has_more가 true로 보고될 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueBluesky Post API 추천 활용 사례
- 알고 있는 게시물 URL 정보 보강: 선택한 bsky.app 링크를 본문, 작성자, 미디어, 타임스탬프, 태그, 멘션, 지표, 출처 필드로 구성된 구조화된 데이터로 변환합니다.
- 콘텐츠와 출처 검토: 게시물 본문, 작성자 정보, 미디어, 공개 원본 URL로 선택한 게시물을 출처를 추적할 수 있는 상태에서 살펴봅니다.
- 참여도 관측값 비교: 공개된 참여 수치를 collected_at과 짝지어, 따로 수집한 스냅샷을 실시간 스트림으로 취급하지 않고 비교합니다.
Bluesky Post API 활용 팁
- 파싱된 호스트 이름이 bsky.app 또는 bsky.app 서브도메인인지 확인하세요. 제출 검증기는 URL 스킴을 제한하지 않으며 프로토콜 상대 참조도 허용합니다.
- 입력이 피드 페이지가 아니라 선택한 게시물 하나를 가리키므로, 작업마다 게시물 URL을 하나만 사용하고 results_limit은 생략하세요.
- 게시물 본문, 작성자 정보, 미디어, 해시태그, 멘션, 게시 시각, 개별 지표는 null일 수 있는 필드로 취급하세요.
- 공개된 참여 수치와 함께 collected_at을 저장해, 나중에 비교할 때 각 관측 시점을 보존하세요.
관련 API
Bluesky Post API 외에 Bluesky의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Bluesky Profile API — 검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 이미지, 웹사이트, 상태 필드, 공개된 계정 수치, 수집 맥락을 포함합니다.
- Bluesky User Posts API — 핸들 또는 DID로 공개 Bluesky 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.