Bluesky Users API

Endpoint

GET /v1/bluesky/users

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-20 (default: 1). Each page returns up to 50 users; you are billed per page returned.

Response fields

users

Array of matching users

username

Bluesky handle

full_name

Display name

user_id

DID (permanent account ID)

biography

Profile description

is_verified

Whether the account is verified

profile_pic_url

URL to profile picture

date_joined

Account creation date and time

url

Link to the profile

pages

Number of pages returned

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/bluesky/users?query=anthropic&pages=1"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/bluesky/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "anthropic", "pages": 1}
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "anthropic.com",
      "full_name": "Anthropic",
      "user_id": "did:plc:7xblllgnpqtiotu62pic747n",
      "biography": "We're an Al safety and research company that builds reliable, interpretable, and steerable Al systems. Talk to our Al assistant Claude at Claude.ai.",
      "is_verified": false,
      "profile_pic_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:7xblllgnpqtiotu62pic747n/bafkreifymuozievn7kgdpqlqmbhycgcmzg2zytdtsks5diw4ost34iybjm",
      "date_joined": "2024-11-19 19:33:47",
      "url": "https://bsky.app/profile/anthropic.com"
    }
  ],
  "pages": 1,
  "count": 50
}

Frequently asked questions

What does the search match on?

Bluesky matches the keyword against handles, display names, and profile descriptions, ranked by relevance.

Are follower counts included?

Not on search results. Look up any account with [User Profile](/docs/bluesky-user) for follower, following, and post counts.

How does pricing work?

You only pay for successful requests. The Bluesky Users API costs $0.003 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.