{"name":"Bluesky Followers API","description":"List the followers of a Bluesky account, with handle, display name and profile details.","api_id":"generated_9464169d0f948d1affbe969e","slug":"bluesky-followers-api","source":{"name":"Bsky","domain":"public.api.bsky.app","url":"https://public.api.bsky.app/"},"category":"social_communities","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-17","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-16T11:18:48.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_9464169d0f948d1affbe969e_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"51fe72a42ee084caa198fe87ad033a80f38ed0092f0d4032fea5f42465716e42","method":"POST","path":"/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"actor":{"type":"string","minLength":1,"maxLength":200,"examples":["jan0ski.net","justmask.bsky.social"],"default":"jay.bsky.team","description":"Optional. 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."}},"required":["actor"],"additionalProperties":false},"output_schema":{"additionalProperties":true,"properties":{"allow_group_invites":{"type":["string"]},"allow_incoming":{"type":["string"]},"allow_subscriptions":{"type":["string"]},"associated":{"type":["object"],"x-cleanedweb-source-value-opaque":true},"createdAt":{"type":["string"]},"description":{"type":["string"]},"did":{"type":["string"]},"displayName":{"type":["string"]},"handle":{"type":["string"]},"indexedAt":{"type":["string"]},"labels":{"type":["array"],"x-cleanedweb-source-value-opaque":true},"labels_cid":{"items":{"type":["string"]},"type":["array"]},"labels_cts":{"items":{"type":["string"]},"type":["array"]},"labels_src":{"items":{"type":["string"]},"type":["array"]},"labels_uri":{"items":{"type":["string"]},"type":["array"]},"labels_val":{"items":{"type":["string"]},"type":["array"]},"labels_ver":{"items":{"type":["number"]},"type":["array"]},"pronouns":{"type":["string"]}},"required":["did"],"type":"object"},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-16T11:18:48.175Z","live_verified":false,"request":{"input":{}},"records_shown":1,"records_saved":1,"records":[{"allow_incoming":"all","allow_subscriptions":"followers","createdAt":"2025-04-04T20:57:25.295Z","did":"did:plc:mz4m6yo275wmhyjucq5n4cgu","displayName":"Mask","handle":"justmask.bsky.social","indexedAt":"2025-04-16T12:06:47.974Z","labels_cts":["2025-04-16T14:01:50.057Z"],"labels_src":["did:plc:ar7c4by46qjdydhdevvrndac"],"labels_uri":["did:plc:mz4m6yo275wmhyjucq5n4cgu"],"labels_val":["spam"],"labels_ver":[1]}]}],"request_example":{"body":{"input":{"actor":"jay.bsky.team"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"actor\": \"jay.bsky.team\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/bluesky-followers-api/","markdown":"https://cleanedweb.com/catalog/bluesky-followers-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_9464169d0f948d1affbe969e/endpoints/generated_9464169d0f948d1affbe969e_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/bluesky-followers-api/","markdown":"https://cleanedweb.com/catalog/bluesky-followers-api/index.md","contract":"https://cleanedweb.com/catalog/bluesky-followers-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
