---
title: "Search Bluesky accounts"
method: GET
path: "/bluesky/search-actors"
tags: ["Bluesky"]
---

# Search Bluesky accounts

`GET /bluesky/search-actors`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/bluesky/search-actors`
- Auth: API key in header `x-api-key`

Returns Bluesky accounts matching a query against display name, handle, and profile description.

## Query parameters

- `q` string, required
- `limit` integer
- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BlueskySearchActorsResponseDoc
  - `code` integer
  - `data` BlueskySearchActorsResponse
    - `actors` BlueskyActor[]
      - `avatar_url` string
      - `created_at` string
      - `description` string
      - `did` string
      - `display_name` string
      - `handle` string
    - `cursor` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)