Search APIs
Loading…
← API Store
Social

Bluesky

Bluesky

Search Bluesky users

GET /bluesky/v1/search/users
Test this endpoint

Every 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

NameTypeDescription
qrequiredstring Example: science
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.querystring
$.usersarray
$.users[]object | string
$.users[].avatarstring
$.users[].created_atstring
$.users[].descriptionstring
$.users[].didstring
$.users[].handlestring
$.users[].indexed_atstring
$.users[].labelernull
$.users[].labelsarray
$.users[].namestring
$.users[].pronounsnull
$.users[].trusted_verifierboolean
$.users[].urlstring
$.users[].verifiedboolean
$.users[].viewernull