# Bluesky API

> Bluesky API on Apizie: 8 endpoints (Profile, Get Trending Topics, Search Posts, Search Users, …) returned as clean JSON through one API key. 8 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/social-media:bluesky/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `social-media:bluesky`
- Category: Social Media
- Status: live
- Source: https://bsky.app
- Page: https://zieapi.vercel.app/api/social-media/bluesky
- OpenAPI: https://zieapi.vercel.app/api/social-media/bluesky/openapi.json

Public Bluesky profiles, posts, threads, social graph and search via the AppView XRPC API.

## Endpoints

### Profile
`GET https://zieapi.vercel.app/v1/social-media:bluesky/profile/:handle`

| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle or DID |

### Get Trending Topics
`GET https://zieapi.vercel.app/v1/social-media:bluesky/trends`

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | Results per page |

### Search Posts
`GET https://zieapi.vercel.app/v1/social-media:bluesky/search-posts`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes |  |
| limit | integer | no | Results per page |
| sort | string | no |  |
| lang | string | no |  |
| author | string | no |  |
| since | string | no | ISO datetime or YYYY-MM-DD |
| until | string | no |  |
| cursor | string | no |  |

### Search Users
`GET https://zieapi.vercel.app/v1/social-media:bluesky/search-users`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes |  |
| limit | integer | no | Results per page |
| cursor | string | no |  |

### Get Followers
`GET https://zieapi.vercel.app/v1/social-media:bluesky/followers/:handle`

| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle or DID |
| limit | integer | no | Results per page |
| cursor | string | no |  |

### Get Following
`GET https://zieapi.vercel.app/v1/social-media:bluesky/following/:handle`

| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle or DID |
| limit | integer | no | Results per page |
| cursor | string | no |  |

### Get Post Thread
`GET https://zieapi.vercel.app/v1/social-media:bluesky/post`

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes |  |
| depth | integer | no |  |

### Author Feed
`GET https://zieapi.vercel.app/v1/social-media:bluesky/feed/:handle`

| Parameter | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | Handle or DID |
| limit | integer | no | Results per page |
| cursor | string | no |  |
| filter | string | no |  |

## Example
```
curl "https://zieapi.vercel.app/v1/social-media:bluesky/profile" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Bluesky API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/social-media:bluesky/profile with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Bluesky API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Bluesky API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key social-media:bluesky.

### What is the status of the Bluesky API?
Live: works with just an Apizie key