← API Store
Social
Bluesky
Bluesky
Search Bluesky users
GET /bluesky/v1/search/usersEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Example: science |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 100,
"credits_used": 1,
"next_cursor": "eyJzIjpbMTAwMCwyLjU4Njg5MDhlLTcsImRpZDpwbGM6b2d4bnl5anAzYndjdHh5ZXB4M2JwamF6Il19",
"query": "science",
"users": [
{
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:rjtifgmgwnacwa24lqp4tpsy/bafkreibgimqm3y3yxf4lbwscyg3opr2rcnp3qh4ulnubwlv73suqmwimoi",
"created_at": "2023-06-28T20:01:41.209Z",
"description": "Entertaining & educational conversations about science, tech, + more. Hosted by Ira Flatow and Flora Lichtman. From WNYCStudios.",
"did": "did:plc:rjtifgmgwnacwa24lqp4tpsy",
"handle": "scifri.bsky.social",
"indexed_at": "2025-11-05T17:01:53.652Z",
"labeler": null,
"labels": [],
"name": "Science Friday",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/scifri.bsky.social",
"verified": true,
"viewer": null
},
{
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:vqgovau5gkirnk3ss5qwjdmz/bafkreihcvrkv32bc2gkpygeiwe6hhhtrbgmc5lpow3gycawzwnoaa5dy2e",
"created_at": "2024-11-22T17:49:40.255Z",
"description": "Cutting-edge research, news, commentary, and visuals from the Science family of journals. https://www.science.org",
"did": "did:plc:vqgovau5gkirnk3ss5qwjdmz",
"handle": "science.org",
"indexed_at": "2026-10-22T18:18:47.938Z",
"labeler": null,
"labels": [],
"name": "Science Magazine",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/science.org",
"verified": true,
"viewer": null
},
"… 98 more"
]
} Response fields (22)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.query | string |
$.users | array |
$.users[] | object | string |
$.users[].avatar | string |
$.users[].created_at | string |
$.users[].description | string |
$.users[].did | string |
$.users[].handle | string |
$.users[].indexed_at | string |
$.users[].labeler | null |
$.users[].labels | array |
$.users[].name | string |
$.users[].pronouns | null |
$.users[].trusted_verifier | boolean |
$.users[].url | string |
$.users[].verified | boolean |
$.users[].viewer | null |