Profile

GET/v1/bluesky/profile1 credit

Returns a Bluesky profile: DID, handle, display name, bio, avatar and banner, follower, following and post counts, verification state, creation date and pinned post.

01Query parameters

Name	Type	Description
handlerequired	string	The Bluesky handle (e.g. `bsky.app`; a leading `@` is stripped) or a DID.

02Request

curl "https://api.scrapesocial.ai/v1/bluesky/profile?handle=bsky.app" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/bluesky/profile?handle=bsky.app

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
  "handle": "bsky.app",
  "displayName": "Bluesky",
  "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka",
  "associated": {
    "lists": 18,
    "feedgens": 7,
    "starterPacks": 15,
    "labeler": false,
    "chat": {
      "allowIncoming": "none"
    },
    "activitySubscription": {
      "allowSubscriptions": "followers"
    }
  },
  "labels": [],
  "createdAt": "2023-04-12T04:53:57.057Z",
  "verification": {
    "verifications": [],
    "verifiedStatus": "none",
    "trustedVerifierStatus": "valid"
  },
  "status": {
    "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.actor.status/self",
    "cid": "bafyreihkojqw7p22odgjcbzjh5sh4vrntow24sd4nvntpqnddrd5pqma44",
    "record": {
      "$type": "app.bsky.actor.status",
      "createdAt": "2026-10-20T16:00:37.680Z",
      "durationMinutes": 60,
      "embed": {
        "$type": "app.bsky.embed.external",
        "external": {
          "$type": "app.bsky.embed.external#external",
          "description": "Elon Take The Wheel Livestream: Alex Gibney, Director of \"MUSK\"",
          "thumb": {
            "$type": "blob",
            "ref": {
              "$link": "bafkreifbiu2m3dnnhmzq4dk6u4227p3xuq3zzqhhzvibhuojnz6unengny"
            },
            "mimeType": "image/jpeg",
            "size": 195438
          },
          "title": "e.w. niedermeyer is live on Streamplace",
          "uri": "https://stream.place/niedermeyer.online"
        }
      },
      "status": "app.bsky.actor.status#live"
    },
    "status": "app.bsky.actor.status#live",
    "embed": {
      "external": {
        "uri": "https://stream.place/niedermeyer.online",
        "title": "e.w. niedermeyer is live on Streamplace",
        "description": "Elon Take The Wheel Livestream: Alex Gibney, Director of \"MUSK\"",
        "thumb": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreifbiu2m3dnnhmzq4dk6u4227p3xuq3zzqhhzvibhuojnz6unengny"
      },
      "$type": "app.bsky.embed.external#view"
    },
    "labels": [],
    "expiresAt": "2026-10-20T17:00:37.680Z",
    "isActive": false
  },
  "description": "official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: [email protected]",
  "indexedAt": "2025-10-27T21:05:26.152Z",
  "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreichzyovokfzmymz36p5jibbjrhsur6n7hjnzxrpbt5jaydp2szvna",
  "followersCount": 35380768,
  "followsCount": 25,
  "postsCount": 896,
  "pinnedPost": {
    "cid": "bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq",
    "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The profile fields are at the top level of the answer. An unknown account is a free 404; a value that is neither a handle nor a DID is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.