bluesky/
post

알고 있는 bsky.app URL에서 공개 Bluesky 게시물 하나를 수집하여 본문, 작성자 정보, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여도를 반환합니다.

Bluesky Post API

게시물 URL 1개
작성자 정보
참여도 스냅샷
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 따라간 뒤, 표준 결과 구조에서 정규화된 결과를 읽습니다.

  1. 확인하려는 Bluesky 게시물로 연결되는 공개 bsky.app URL을 하나 준비합니다.
  2. URL을 url로 /v1/bluesky/post에 제출하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Bluesky Post API 추천 활용 사례

  • 알고 있는 게시물 URL 정보 보강: 선택한 bsky.app 링크를 본문, 작성자, 미디어, 타임스탬프, 태그, 멘션, 지표, 출처 필드로 구성된 구조화된 데이터로 변환합니다.
  • 콘텐츠와 출처 검토: 게시물 본문, 작성자 정보, 미디어, 공개 원본 URL로 선택한 게시물을 출처를 추적할 수 있는 상태에서 살펴봅니다.
  • 참여도 관측값 비교: 공개된 참여 수치를 collected_at과 짝지어, 따로 수집한 스냅샷을 실시간 스트림으로 취급하지 않고 비교합니다.

Bluesky Post API 활용 팁

  • 파싱된 호스트 이름이 bsky.app 또는 bsky.app 서브도메인인지 확인하세요. 제출 검증기는 URL 스킴을 제한하지 않으며 프로토콜 상대 참조도 허용합니다.
  • 입력이 피드 페이지가 아니라 선택한 게시물 하나를 가리키므로, 작업마다 게시물 URL을 하나만 사용하고 results_limit은 생략하세요.
  • 게시물 본문, 작성자 정보, 미디어, 해시태그, 멘션, 게시 시각, 개별 지표는 null일 수 있는 필드로 취급하세요.
  • 공개된 참여 수치와 함께 collected_at을 저장해, 나중에 비교할 때 각 관측 시점을 보존하세요.

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

  • Bluesky Profile API — 검증된 사용자 이름으로 공개 Bluesky 프로필 하나를 가져오며, 정규화된 계정 정보, 소개글, 이미지, 웹사이트, 상태 필드, 공개된 계정 수치, 수집 맥락을 포함합니다.
  • Bluesky User Posts API — 핸들 또는 DID로 공개 Bluesky 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

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

Bluesky Post API — 자주 묻는 질문

Bluesky Post API는 알고 있는 게시물 URL에서 공개 Bluesky 게시물 하나를 가져오는 프로그래밍 인터페이스입니다. 정규화된 본문, 작성자 정보, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여 수치를 반환합니다.

파싱된 호스트 이름이 bsky.app 또는 bsky.app 서브도메인인, 비어 있지 않은 참조를 하나 제출합니다. 백엔드는 모든 스킴의 절대 URL과 프로토콜 상대 참조를 허용하며, 요청은 url 필드만 받습니다.

게시물 스키마에는 식별·출처 필드, 본문, 게시·수집 시각, 작성자 정보, 미디어, 해시태그, 멘션, 확인 가능한 좋아요·댓글·리포스트·조회 수가 포함됩니다. null이 될 수 있는 필드는 공개 원본이 사용할 수 있는 값을 제공하지 않으면 비어 있습니다.

아니요. 결과는 선택한 게시물을 나타내며 공개된 comments_count는 포함할 수 있지만, 게시물 스키마는 별도의 답글 레코드나 답글 트리를 반환하지 않습니다.

아니요. 요청은 url 하나만 처리하며 results_limit을 받지 않습니다. 반환된 항목은 표준 작업 결과 구조로 읽으세요.

Bluesky Post 작업은 성공할 때마다 고정 0.19 SocQ 크레딧이 차감됩니다. 요청하거나 반환된 결과 수와는 관계없이 같은 요금이 적용됩니다.