Interact with 'Bluesky' Social
Overview
Collect data from and make posts on 'Bluesky' Social via the Hypertext Transfer Protocol (HTTP) Application Programming Interface (API), as documented at https://atproto.com/specs/xrpc. This further supports broader queries to the Authenticated Transfer (AT) Protocol https://atproto.com/ which 'Bluesky' Social relies on. Data is returned in a tidy format and posts can be made using a simple interface.
- Fixes an issue where OpenGraph links with a size hint would fail downloading. (#32)
- Improves transformations of starter packs into tibbles with cleaner unnesting. (#31)
- Allows for more than 25 actors in
bs_get_profile(), (#29, #30). - No longer overly widens results in
bs_get_profile(). (#42) - Improves
bs_get_likes()processing and makes it clear it is self-only. - Adds 3 vignettes. (#12)
- "Creating Records on Bluesky Social"
- "Gathering Data from Bluesky Social"
- "Working with Lists and Starter Packs"
- Adds support for direct messages or conversations (aka "convos").
bs_list_convos()lists all conversationsbs_get_messages()retrieves messages from a conversation
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
bs_get_convo()retrieves details on a conversationbs_get_convo_log()retrieves the log on all conversationsbs_update_read()sets a conversation to readbs_update_all_read()sets all conversations to readbs_accept_convo()accepts a conversationbs_add_reaction()adds a reaction to a messagebs_remove_reaction()removes a reaction to a messagebs_mute_convo()mutes a conversationbs_unmute_convo()unmutes a conversationbs_send_message()sends a message to a conversationbs_delete_message_for_self()hides a message for youbs_leave_convo()leaves a conversationbs_get_convo_availability()retrieves info on if you can chat with another actorbs_send_message_batch()sends a batch of messages to different conversations- Fixes an issue where actual numbers with a # sign would cause failures in posting (#45).
- Avoids creating raw version of files for upload where possible (#16).
- Always returns
embedforbs_get_posts()(#40, #41). - Include all returned information in
bs_get_author_feed(). Note that this requires adding a prefix toreplyandreasoninformation. (#43)
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK14 OK2026-03-10
Documentation
- Help pages
- 84
- Examples that run
- 100%84 run in a plain check (77 of them under a condition)
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 62%
- Median days to close, 50 most recently updated closed issues
- 86
- Median days to close, 50 most recently updated closed PRs
- 8
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
11 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/christopherkenny/bskyr on 2026-10-22.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-07-01 · The repository has a site deploy workflow
pkgdown site last built 2026-07-01
Show all practicesHide 3 practices
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.4.0Latest2025-10-25 · current release · diff ↗ ·
added 17 exports
bs_accept_convo, bs_add_reaction, bs_delete_message_for_self, bs_get_convo, bs_get_convo_availability, bs_get_convo_for_members, bs_get_convo_log, bs_get_messages, bs_leave_convo, bs_list_convos, bs_mute_convo, bs_remove_reaction, bs_send_message, bs_send_message_batch, bs_unmute_convo, bs_update_all_read, bs_update_read - 0.3.0
- RR 4.5.0 released · 2025-04-11
- 0.2.02025-02-09 · diff ↗ ·
added 23 exports
bs_block, bs_delete_block, bs_delete_follow, bs_delete_like, bs_delete_list, bs_delete_list_item, bs_delete_repost, bs_delete_starter_pack, bs_extract_record_key, bs_follow, bs_get_actor_starter_packs, bs_get_list, bs_get_quotes, bs_get_relationships, bs_get_starter_pack, bs_get_starter_packs, bs_new_list, bs_new_list_item, bs_new_starter_pack, bs_unblock, bs_unfollow, bs_unlike, bs_url_to_uri - RR 4.4.0 released · 2024-04-24
- 0.1.2
- 0.1.02023-11-26 · diff ↗ ·
added 11 exports
bs_create_record, bs_created_at, bs_delete_record, bs_describe_repo, bs_get_record, bs_like, bs_list_records, bs_repost, bs_resolve_handle, bs_upload_blob, bs_uri_to_url - 0.0.42023-11-10
- RR 4.3.0 released · 2023-04-21
Package metadata
- First published
- 2023-11-10
- Total releases
- 6 / 3 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.2.0
- Download size
- 500 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("bskyr")The package provides a citation file, so citation() returns the authors' own entry.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.