API Credentials for Bluesky

To access the Bluesky API you need three pieces of information: 1) the URL of the "Personal Data Server" (PDS) that hosts your account—most users use the public server https://bsky.social—, 2) your "Username" (also called your handle, e.g., user.bsky.social) and 3) an "App Password"—not your sign‑in password—generated in Bluesky’s settings. Below are step‑by‑step instructions for obtaining each item.

Personal Data Server (PDS)

1. 1

   Open the Bluesky app (mobile or web) and navigate to your profile.

2. 2

   Look at the end of your handle (the part after the dot). Most users will see .bsky.social, confirming that your PDS is the public server.

3. 3

   If your handle ends in a different domain (for example .example.com), then your PDS is https://example.com. Otherwise, note https://bsky.social as your "Personal Data Server."

Username

1. 1

   At the top of your profile you’ll see your full handle displayed just below your name and starting with @ (e.g., @maria.bsky.social).

2. 2

   Copy the handle WITHOUT the @ symbol (e.g., maria.bsky.social). That text is your "Username" for the API.

Password (App Password)

1. 1

   From the app or web, tap your profile picture (bottom‑right) and select **Settings**.

2. 2

   Scroll to the **Advanced** section and tap **App Passwords**.

3. 3

   Tap **Create App Password**, give it a name (for example “MyScriptAPI”) and confirm.

4. 4

   Bluesky will display a 16‑character code separated by hyphens (something like abcd-1234-efgh-5678). Copy this code—it’s your "Password" for API calls.

5. 5

   Store the code in a safe place. If you lose it, you’ll need to generate a new one because Bluesky will not show it again for security reasons.