fetchproof.

/v1/bluesky/profile

GET

Profile

Get Bluesky profile info

Credit cost

Default: 1 credit

How charges are determined

Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.

A call that fails costs 0 credits. A result served from cache costs 0 credits.

`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.

A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).

A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.

Cache supportNot specified in the published contract.
PaginationNo explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

NameLocation / requiredSchema
handle

Bluesky handle

query / required

string

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL
curl --request GET 'https://api.fetchproof.com/v1/bluesky/profile?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'
JavaScript
const response = await fetch("https://api.fetchproof.com/v1/bluesky/profile?handle=YOUR_HANDLE", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());
Python
import os
import requests

response = requests.get("https://api.fetchproof.com/v1/bluesky/profile?handle=YOUR_HANDLE",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

didrequired

string

handlerequired

string

displayNamerequired

string

avatarrequired

string

associatedrequired

object

listsrequired

integer

feedgensrequired

integer

starterPacksrequired

integer

labelerrequired

boolean

chatoptional

object

allowIncomingrequired

string

activitySubscriptionoptional

object

allowSubscriptionsrequired

string

labelsrequired

array

createdAtrequired

string

{
  "format": "date-time"
}
verificationrequired

object

verificationsrequired

array

Array items

object

issuerrequired

string

urirequired

string

isValidrequired

boolean

createdAtrequired

string

{
  "format": "date-time"
}
verifiedStatusrequired

string

trustedVerifierStatusrequired

string

descriptionrequired

string

indexedAtrequired

string

{
  "format": "date-time"
}
followersCountrequired

integer

followsCountrequired

integer

postsCountrequired

integer

statusoptional

object

urirequired

string

cidrequired

string

recordrequired

object

$typerequired

string

createdAtrequired

string

{
  "format": "date-time"
}
durationMinutesrequired

integer

embedrequired

object

$typerequired

string

externalrequired

object

$typerequired

string

descriptionrequired

string

thumbrequired

object

$typerequired

string

refrequired

object

$linkrequired

string

mimeTyperequired

string

sizerequired

integer

titlerequired

string

urirequired

string

statusrequired

string

statusrequired

string

embedrequired

object

externalrequired

object

urirequired

string

titlerequired

string

descriptionrequired

string

thumbrequired

string

$typerequired

string

labelsrequired

array

expiresAtrequired

string

{
  "format": "date-time"
}
isActiverequired

boolean

banneroptional

string

pinnedPostoptional

object

cidrequired

string

urirequired

string

401Invalid or missing x-api-key
402No credits remaining
403Upstream denied (age gate, audience controls)
404Resource or endpoint not found
429Rate limited