{"name":"Bluesky Profile API","description":"Get a Bluesky account's profile by handle, with display name, bio and follower counts.","api_id":"generated_46521fab9bd1f3ab7e179c9d","slug":"bluesky-profile-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-18","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-17T16:46:34.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_46521fab9bd1f3ab7e179c9d_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"e18368c879168479bd12a9428fa044a28e96b49d5defeb7ea0b073923eb825f4","method":"POST","path":"/v1/catalog/public/apis/generated_46521fab9bd1f3ab7e179c9d/endpoints/generated_46521fab9bd1f3ab7e179c9d_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_46521fab9bd1f3ab7e179c9d/endpoints/generated_46521fab9bd1f3ab7e179c9d_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":{"actors":{"type":"string","minLength":1,"maxLength":200,"examples":["jack.bsky.social","dril.bsky.social"],"default":"jay.bsky.team","description":"Optional. Free text for the page's own \"actors\" box, sent as its query key exactly as typed. Omit it for the page's own records."}},"required":[],"additionalProperties":false},"output_schema":{"additionalProperties":true,"properties":{"allow_incoming":{"type":["string"]},"allow_subscriptions":{"type":["string"]},"associated":{"type":["object"],"x-cleanedweb-source-value-opaque":true},"banner":{"type":["string"]},"createdAt":{"type":["string"]},"description":{"type":["string"]},"did":{"type":["string"]},"displayName":{"type":["string"]},"feedgens":{"type":["number"]},"followersCount":{"type":["number"]},"followsCount":{"type":["number"]},"handle":{"type":["string"]},"indexedAt":{"type":["string"]},"labeler":{"type":["boolean"]},"labels":{"type":["array"],"x-cleanedweb-source-value-opaque":true},"lists":{"type":["number"]},"postsCount":{"type":["number"]},"starter_packs":{"type":["number"]},"trusted_verifier_status":{"type":["string"]},"verification":{"type":["object"],"x-cleanedweb-source-value-opaque":true},"verifications_created_at":{"items":{"type":["string"]},"type":["array"]},"verifications_is_valid":{"items":{"type":["boolean"]},"type":["array"]},"verifications_issuer":{"items":{"type":["string"]},"type":["array"]},"verifications_issuer_display_name":{"items":{"type":["string"]},"type":["array"]},"verifications_issuer_handle":{"items":{"type":["string"]},"type":["array"]},"verifications_uri":{"items":{"type":["string"]},"type":["array"]},"verified_status":{"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-17T16:46:34.091Z","live_verified":false,"request":{"input":{}},"records_shown":1,"records_saved":1,"records":[{"allow_incoming":"following","allow_subscriptions":"followers","banner":"https://cdn.bsky.app/img/banner/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreicgnmvhtmj4arcvwhueygbwvkucd3odvom3lxtfmn6wlqbh3yf7p4","createdAt":"2022-11-17T06:31:40.296Z","description":"Founder & Chief Innovation Officer @ Bluesky\n\nWorking on @attie.ai\n\n🌱 🪴 🌳","did":"did:plc:oky5czdrnfjpqslsw2a5iclo","displayName":"Jay 🦋","feedgens":0,"followersCount":594408,"followsCount":3994,"handle":"jay.bsky.team","indexedAt":"2026-03-29T21:16:33.460Z","labeler":false,"lists":0,"postsCount":4186,"starter_packs":0,"trusted_verifier_status":"none","verifications_created_at":["2025-04-21T11:35:53.359Z"],"verifications_is_valid":[true],"verifications_issuer":["did:plc:z72i7hdynmk6r22z27h6tvur"],"verifications_issuer_display_name":["Bluesky"],"verifications_issuer_handle":["bsky.app"],"verifications_uri":["at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndslpegeo2f"],"verified_status":"valid"}]}],"request_example":{"body":{"input":{},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_46521fab9bd1f3ab7e179c9d/endpoints/generated_46521fab9bd1f3ab7e179c9d_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  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_46521fab9bd1f3ab7e179c9d/endpoints/generated_46521fab9bd1f3ab7e179c9d_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-profile-api/","markdown":"https://cleanedweb.com/catalog/bluesky-profile-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_46521fab9bd1f3ab7e179c9d/endpoints/generated_46521fab9bd1f3ab7e179c9d_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/bluesky-profile-api/","markdown":"https://cleanedweb.com/catalog/bluesky-profile-api/index.md","contract":"https://cleanedweb.com/catalog/bluesky-profile-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
