Skip to contents

Interact with posts

Create, edit, and delete records including posts, reposts, and likes

bs_block()
Block an account
bs_follow()
Follow an account
bs_like()
Like an existing post
bs_new_list()
Create a list
bs_new_list_item()
Add a subject to a list
bs_post()
Make a post on Bluesky Social
bs_repost()
Repost an existing post

Actor

Functions related to an actor (a user)

bs_get_actor_suggestions()
Get a list of actors suggested for following
bs_get_preferences()
Get (Self) Preferences
bs_get_profile()
Get Profile for a Bluesky Social User
bs_search_actors()
Find profiles matching search criteria

Authentication

Functions for authenticating bskyr users

bs_auth()
Authenticate a user
has_bluesky_pass() get_bluesky_pass() bs_get_pass() bs_has_pass()
Check or Get Bluesky App Password
set_bluesky_pass() bs_set_pass()
Add Entry to Renviron
set_bluesky_user() bs_set_user()
Adds Bluesky User to .Renviron.
has_bluesky_user() get_bluesky_user() bs_get_user() bs_has_user()
Check or Get Bluesky User

Feed

Functions which describe feeds (essentially timelines filled with posts)

bs_get_author_feed()
Retrieve posts on an actor's feed
bs_get_feed()
Build feed from user's feed generator
bs_get_feed_generator()
Get specific information about one feed generator
bs_get_feed_generators()
Get information about a list of feed generators
bs_get_feed_suggestions()
Get a list of feed suggestions
bs_get_feeds()
Retrieve a list of feeds created by a given actor
bs_get_likes()
Retrieve posts liked by an actor
bs_get_post_likes()
Retrieve likes on a post
bs_get_post_thread()
Retrieve thread of posts
bs_get_posts()
Retrieve thread of posts
bs_get_quotes()
Retrieve a list of quotes for a given post
bs_get_reposts()
Retrieve actors who reposted a post
bs_get_timeline()
Retrieve the user's home timeline
bs_search_posts()
Find posts matching search criteria

Graph

Functions which describe the relationships between users

bs_get_actor_lists()
Get a list of lists that belong to an actor.
bs_get_actor_starter_packs()
Get starter packs created by an actor
bs_get_blocked_lists()
Retrieve a user's (self) muted lists
bs_get_blocks()
Retrieve user (self) blocks
bs_get_follow_suggestions()
Get suggested follows related to a given actor
bs_get_followers()
Retrieve an actor's followers
bs_get_follows()
Retrieve an actor's follows
bs_get_list()
Get a view of a list
bs_get_muted_lists()
Retrieve a user's (self) muted lists
bs_get_mutes()
Retrieve a user's (self) muted accounts
bs_get_relationships()
Get relationships between an account and other users
bs_get_starter_pack()
Get information on one starter pack
bs_get_starter_packs()
Get information about a list of starter packs

Notifications

Interact with your own notifications

bs_get_notification_count()
Get the user's (self) number of unread notifications
bs_get_notifications()
Get the user's (self) notifications

Repo

Procedures for adding and otherwise interacting with records on Bluesky Social

bs_create_record()
Create a record in a repo
bs_delete_block() bs_unblock()
Delete a block
bs_delete_follow() bs_unfollow()
Delete a follow (un-follow someone)
bs_delete_like() bs_unlike()
Delete a like (un-like something)
bs_delete_list()
Delete a list
bs_delete_list_item()
Delete a list item
bs_delete_record()
Delete a record in a repo
bs_delete_repost()
Delete a repost
bs_describe_repo()
Describe a repo
bs_get_record()
Get an arbitrary record from a repo
bs_list_records()
List records in a repo
bs_upload_blob()
Upload a blob to a repo

Other

Other Functions

bs_created_at()
Get current time in Bluesky format
bs_extract_record_key()
Extract Record Key from a link
bs_resolve_handle()
Resolve a Handle to Decentralized Identifier (DID)
bs_uri_to_url()
Convert Universal Resource Identifiers to Hypertext Transfer Protocol Secure URLs
bs_url_to_uri()
Convert Hypertext Transfer Protocol Secure URLs to Universal Resource Identifiers