플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Bluesky 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
프로필profile | Bluesky 핸들로 계정 레코드를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
사용자 게시물user_posts | Bluesky 계정의 게시물을 추적합니다. | 요청 1,000개당 $1.39 | 정상 |
팔로워followers | Bluesky 사용자를 팔로우하는 계정을 나열합니다. | 요청 1,000개당 $1.39 | 정상 |
팔로잉following | Bluesky 사용자가 팔로우하는 계정을 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
인물 검색search_people | 이름이나 검색어와 일치하는 Bluesky 계정을 검색해 핸들, 표시 이름, 소개, 프로필 이미지, 인증 플래그를 반환합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Bluesky 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
profile프로필 Bluesky 핸들로 계정 레코드를 조회합니다. 표시 이름, 소개, 프로필 이미지, 배너, 가입일, 인증 플래그, 팔로워·팔로잉·게시물 수가 포함됩니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform · banner_url · follower_count · following_count · post_count |
user_posts사용자 게시물 Bluesky 계정의 게시물을 추적합니다. 각 게시물에는 텍스트와 URL, 좋아요·리포스트·인용·답글·북마크 수, 해시태그, 멘션, 외부 링크가 포함됩니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · author_username · author_name · author_id · author_avatar_url · lang · like_count · repost_count · comment_count · quote_count · bookmark_count · is_reply · is_repost · posted_at · platform · media_urls · embed_url · embed_title · hashtags · mentions · links |
followers팔로워 Bluesky 사용자를 팔로우하는 계정을 나열합니다. 각 계정에는 DID, 핸들, 표시 이름, 소개, 가입일이 포함됩니다. 반환된 페이지에 모든 팔로워가 포함되지 않을 수 있어 프로필의 팔로워 수와 다를 수 있습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=30, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
following팔로잉 Bluesky 사용자가 팔로우하는 계정을 확인합니다. 각 계정의 ID, 핸들, 표시 이름, 소개, 인증 플래그가 포함됩니다. 팔로우 관계는 시간에 따라 바뀌며, 친밀도나 연락 관계, 메시지를 보내도 된다는 허가를 뜻하지 않습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=30, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
search_people인물 검색 이름이나 검색어와 일치하는 Bluesky 계정을 검색해 핸들, 표시 이름, 소개, 프로필 이미지, 인증 플래그를 반환합니다. 게시물 텍스트가 아니라 프로필을 검색하며, 일치한다고 해서 그 사람의 신원이 확인되는 것은 아닙니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
Bluesky profile 파라미터는 각각 무엇을 의미하나요?
Bluesky 핸들로 계정 레코드를 조회합니다. 표시 이름, 소개, 프로필 이미지, 배너, 가입일, 인증 플래그, 팔로워·팔로잉·게시물 수가 포함됩니다. username에는 표시 이름이나 프로필 링크가 아닌 전체 핸들을 전달하세요(사용자 지정 도메인도 가능).
username필수- alice.bsky.social이나 연결된 사용자 지정 도메인 같은 전체 Bluesky 핸들을 지정합니다. 표시 닉네임이나 bsky.app/profile/ 페이지 URL은 전달하지 마세요. profile, user_posts, followers, following 액션 모두 이 파라미터로 대상 계정을 찾습니다.AT Protocol: 핸들과 DID는 어떻게 다른가 — 이 프로토콜에서 핸들은 도메인 이름 형식의 사용자 식별자로, 변하지 않는 DID로 해석됩니다. 두 값은 서로 바꿔 쓸 수 있는 입력값이 아닙니다. · 확인일
Bluesky user_posts 파라미터는 각각 무엇을 의미하나요?
Bluesky 계정의 게시물을 추적합니다. 각 게시물에는 텍스트와 URL, 좋아요·리포스트·인용·답글·북마크 수, 해시태그, 멘션, 외부 링크가 포함됩니다. quote_count는 단순 리포스트와 별도로, 코멘트를 덧붙인 리포스트를 셉니다. 한 번의 결과가 전체 아카이브는 아닙니다.
username필수- alice.bsky.social이나 연결된 사용자 지정 도메인 같은 전체 Bluesky 핸들을 지정합니다. 표시 닉네임이나 bsky.app/profile/ 페이지 URL은 전달하지 마세요. profile, user_posts, followers, following 액션 모두 이 파라미터로 대상 계정을 찾습니다.AT Protocol: 핸들과 DID는 어떻게 다른가 — 이 프로토콜에서 핸들은 도메인 이름 형식의 사용자 식별자로, 변하지 않는 DID로 해석됩니다. 두 값은 서로 바꿔 쓸 수 있는 입력값이 아닙니다. · 확인일
Bluesky followers 파라미터는 각각 무엇을 의미하나요?
Bluesky 사용자를 팔로우하는 계정을 나열합니다. 각 계정에는 DID, 핸들, 표시 이름, 소개, 가입일이 포함됩니다. 반환된 페이지에 모든 팔로워가 포함되지 않을 수 있어 프로필의 팔로워 수와 다를 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- alice.bsky.social이나 연결된 사용자 지정 도메인 같은 전체 Bluesky 핸들을 지정합니다. 표시 닉네임이나 bsky.app/profile/ 페이지 URL은 전달하지 마세요. profile, user_posts, followers, following 액션 모두 이 파라미터로 대상 계정을 찾습니다.AT Protocol: 핸들과 DID는 어떻게 다른가 — 이 프로토콜에서 핸들은 도메인 이름 형식의 사용자 식별자로, 변하지 않는 DID로 해석됩니다. 두 값은 서로 바꿔 쓸 수 있는 입력값이 아닙니다. · 확인일
Bluesky following 파라미터는 각각 무엇을 의미하나요?
Bluesky 사용자가 팔로우하는 계정을 확인합니다. 각 계정의 ID, 핸들, 표시 이름, 소개, 인증 플래그가 포함됩니다. 팔로우 관계는 시간에 따라 바뀌며, 친밀도나 연락 관계, 메시지를 보내도 된다는 허가를 뜻하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- alice.bsky.social이나 연결된 사용자 지정 도메인 같은 전체 Bluesky 핸들을 지정합니다. 표시 닉네임이나 bsky.app/profile/ 페이지 URL은 전달하지 마세요. profile, user_posts, followers, following 액션 모두 이 파라미터로 대상 계정을 찾습니다.AT Protocol: 핸들과 DID는 어떻게 다른가 — 이 프로토콜에서 핸들은 도메인 이름 형식의 사용자 식별자로, 변하지 않는 DID로 해석됩니다. 두 값은 서로 바꿔 쓸 수 있는 입력값이 아닙니다. · 확인일
Bluesky search_people 파라미터는 각각 무엇을 의미하나요?
이름이나 검색어와 일치하는 Bluesky 계정을 검색해 핸들, 표시 이름, 소개, 프로필 이미지, 인증 플래그를 반환합니다. 게시물 텍스트가 아니라 프로필을 검색하며, 일치한다고 해서 그 사람의 신원이 확인되는 것은 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search_people 액션의 사용자 또는 계정 검색어를 지정합니다. 이 엔드포인트는 일치하는 사용자 프로필을 반환하며 게시물 본문은 검색하지 않습니다. 게시물을 가져오려면 전체 핸들과 함께 user_posts를 사용하세요.
Bluesky API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bluesky","action":"profile","params":{"username":"<username>"}}'
Bluesky API 자주 묻는 질문
Bluesky API로 무엇을 가져올 수 있나요?
platform을 bluesky 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 프로필, 사용자 게시물, 팔로워, 팔로잉 및 인물 검색입니다. 각 액션 이름은 서로 다른 Bluesky 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Bluesky profile 요청에는 어떤 입력이 필요한가요?
alice.bsky.social이나 연결된 사용자 지정 도메인 같은 전체 Bluesky 핸들을 지정합니다. 표시 닉네임이나 bsky.app/profile/ 페이지 URL은 전달하지 마세요. profile, user_posts, followers, following 액션 모두 이 파라미터로 대상 계정을 찾습니다. params 안의 username 필드로 전달하세요.
Bluesky profile 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 user_id, username, display_name 및 bio입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Bluesky 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.