# Bluesky on Onekey

> 32 endpoints for Bluesky (32 stable, 0 beta), 1 to 5 credits each. Category: Social networks. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/bluesky
Reference (Markdown): https://onekey.dev/docs/api/bluesky.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 32 mapped Bluesky endpoints return each:

- `content.text` (string): 31
- `author.id` (string): 29
- `author.username` (string): 29
- `author.displayName` (string): 21
- `content.id` (string): 21
- `engagement.likes` (integer): 20
- `author.avatarUrl` (URL): 19
- `engagement.comments` (integer): 14
- `content.createdAt` (ISO 8601 date): 13
- `content.language` (string): 11
- `content.title` (string): 11
- `engagement.shares` (integer): 11
- `engagement.bookmarks` (integer): 10
- `author.followers` (integer): 2
- `author.following` (integer): 2
- `entity.name` (string): 2
- `entity.description` (string): 1
- `media.thumbnailUrl` (URL): 1

## Endpoints

### bluesky.actor_feeds

Custom feeds published by a Bluesky user.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/actor_feeds?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/actor_feeds.md

### bluesky.actor_lists

Lists created by a Bluesky user.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/actor_lists?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/actor_lists.md

### bluesky.actor_starter_packs

Starter packs created by a Bluesky user.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/actor_starter_packs?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/actor_starter_packs.md

### bluesky.feed

Posts from a Bluesky custom feed.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/feed?feed=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.generator%2Fwhats-hot` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `feed` (string, required): Feed generator AT URI
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/feed.md

### bluesky.feed_generator

Details of a Bluesky custom feed generator.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/feed_generator?feed=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.generator%2Fwhats-hot` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `feed` (string, required): Feed generator AT URI
- Fields returned: `content.id`, `content.title`, `content.text`, `author.id`, `author.username`, `author.displayName`, `media.thumbnailUrl`, `engagement.likes`, `content.createdAt`
- Reference: https://onekey.dev/docs/api/bluesky/feed_generator.md

### bluesky.feed_generators

Details for a Bluesky feed generator (batch lookup form).
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/feed_generators?feed=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.generator%2Fwhats-hot` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `feed` (string, required): Feed generator AT URI
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/feed_generators.md

### bluesky.followers

Followers of a Bluesky account.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/followers?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/followers.md

### bluesky.follows

Accounts a Bluesky user follows.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/follows?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/follows.md

### bluesky.likes

Accounts that liked a Bluesky post.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/likes?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/likes.md

### bluesky.list

A Bluesky list's metadata.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/list?list=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.graph.list%2F3lvpca43j5z26` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `list` (string, required): List AT URI
- Fields returned: `content.id`, `content.title`, `content.text`, `author.id`, `author.username`, `engagement.likes`, `content.language`
- Reference: https://onekey.dev/docs/api/bluesky/list.md

### bluesky.list_members

Members of a Bluesky list.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/list_members?list=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.graph.list%2F3lvpca43j5z26` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `list` (string, required): List AT URI
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/list_members.md

### bluesky.media

Bluesky user's posts that contain media.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/media?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/media.md

### bluesky.popular_feeds

Popular Bluesky feed generators.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/popular_feeds?q=news` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, optional, default news): Optional filter
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/popular_feeds.md

### bluesky.post_replies

Direct replies to a Bluesky post.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/post_replies?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/post_replies.md

### bluesky.post_thread

A Bluesky post with its counts (thread root).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/post_thread?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/post_thread.md

### bluesky.posts

Latest posts by a Bluesky user.
- Price: 1 credit per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/posts?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `content.text`, `content.createdAt`, `engagement.likes`, `engagement.comments`, `engagement.shares`
- Reference: https://onekey.dev/docs/api/bluesky/posts.md

### bluesky.posts_by_uri

Look up a Bluesky post by AT URI.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/posts_by_uri?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/posts_by_uri.md

### bluesky.posts_no_replies

Bluesky user's posts excluding replies.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/posts_no_replies?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/posts_no_replies.md

### bluesky.posts_with_replies

Bluesky user's posts including replies.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/posts_with_replies?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/posts_with_replies.md

### bluesky.profile

Fetch a Bluesky user's public profile.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/profile?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.followers`, `author.following`, `engagement.comments`, `content.text`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/bluesky/profile.md

### bluesky.profiles

Fetch two Bluesky profiles in one call.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/profiles?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `handle2` (string, optional, default jay.bsky.team): Second handle or DID (default jay.bsky.team)
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `author.followers`, `author.following`
- Reference: https://onekey.dev/docs/api/bluesky/profiles.md

### bluesky.quotes

Quote posts of a Bluesky post.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/quotes?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/quotes.md

### bluesky.reposted_by

Accounts that reposted a Bluesky post.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/reposted_by?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3mw2cdr44fc2a` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `uri` (string, required): Post AT URI
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/reposted_by.md

### bluesky.resolve_handle

Resolve a Bluesky handle to its DID.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/resolve_handle?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle, e.g. bsky.app
- Fields returned: `author.id`
- Reference: https://onekey.dev/docs/api/bluesky/resolve_handle.md

### bluesky.search

Search Bluesky users by keyword.
- Price: 1 credit per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/search?q=bluesky` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `author.id`, `author.username`, `author.displayName`, `content.text`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/bluesky/search.md

### bluesky.search_typeahead

Bluesky account typeahead suggestions.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/search_typeahead?q=bsky` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
- Fields returned: `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`
- Reference: https://onekey.dev/docs/api/bluesky/search_typeahead.md

### bluesky.starter_pack

A Bluesky starter pack.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/bluesky/starter_pack?pack=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.graph.starterpack%2F3mv3qhvnmkd2l` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `pack` (string, required): Starter pack AT URI
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `author.id`, `engagement.likes`, `engagement.comments`
- Reference: https://onekey.dev/docs/api/bluesky/starter_pack.md

### bluesky.suggested_feeds

Suggested Bluesky feed generators.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/suggested_feeds` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `content.title`, `content.text`, `author.username`, `engagement.likes`
- Reference: https://onekey.dev/docs/api/bluesky/suggested_feeds.md

### bluesky.threads

Bluesky user's posts and own threads.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/threads?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/threads.md

### bluesky.trending_topics

Bluesky trending topics.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/trending_topics` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `content.title`, `content.text`, `entity.name`
- Reference: https://onekey.dev/docs/api/bluesky/trending_topics.md

### bluesky.trends

Bluesky trends with post counts.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/trends` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `content.id`, `content.title`, `content.text`, `engagement.comments`, `content.createdAt`, `entity.name`, `entity.description`
- Reference: https://onekey.dev/docs/api/bluesky/trends.md

### bluesky.videos

Bluesky user's posts that contain video.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/bluesky/videos?handle=bsky.app` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `handle` (string, required): Bluesky handle or DID, e.g. bsky.app
- Fields returned: `content.id`, `author.id`, `author.username`, `author.displayName`, `author.avatarUrl`, `content.text`, `content.createdAt`, `content.language`, `engagement.likes`, `engagement.comments`, `engagement.shares`, `engagement.bookmarks`
- Reference: https://onekey.dev/docs/api/bluesky/videos.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/bluesky/feed_generator?feed=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.generator%2Fwhats-hot" \
  -H "x-api-key: YOUR_API_KEY"
```