What you get
| Field | Type | Sample value |
|---|---|---|
description |
string | not in the saved sample |
allow_incoming |
string | all |
allow_subscriptions |
string | followers |
createdAt |
string | 2025-04-04T20:57:25.295Z |
did |
string | did:plc:mz4m6yo275wmhyjucq5n4cgu |
displayName |
string | Mask |
handle |
string | justmask.bsky.social |
indexedAt |
string | 2025-04-16T12:06:47.974Z |
All 18 fields
Key fields
descriptionallow_incomingallow_subscriptionscreatedAtdiddisplayNamehandleindexedAt
Technical fields
allow_group_invitesassociatedlabelslabels_cidlabels_ctslabels_srclabels_urilabels_vallabels_verpronouns
Every field with its type, and the schemas, are in contract.json.
Sample records
1 saved record. This is a saved sample, not a live run.
allow_incoming |
allow_subscriptions |
createdAt |
did |
displayName |
handle |
|---|---|---|---|---|---|
| all | followers | 2025-04-04T20:57:25.295Z | did:plc:mz4m6yo275wmhyjucq5n4cgu | Mask | justmask.bsky.social |
Scroll sideways to see more columns.
Inputs
-
actorstring · requiredOptional. Free text for the page's own "actor" box, sent as its query key exactly as typed. Omit it for the page's own records. Default: jay.bsky.team.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"actor": "jay.bsky.team"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Bluesky Followers API.
The agent calls get_api with generated_9464169d0f948d1affbe969e, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Social & communities
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Bsky.