Skip to content

bskyr

0.4.0Package record

Interact with 'Bluesky' Social

0packages depend
10.9Kdownloads / year
81.9%test coverage
13/13flavors OK

Overview

About

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.

Changes in 0.4.0
  • 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 conversations
  • bs_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 conversation
  • bs_get_convo_log() retrieves the log on all conversations
  • bs_update_read() sets a conversation to read
  • bs_update_all_read() sets all conversations to read
  • bs_accept_convo() accepts a conversation
  • bs_add_reaction() adds a reaction to a message
  • bs_remove_reaction() removes a reaction to a message
  • bs_mute_convo() mutes a conversation
  • bs_unmute_convo() unmutes a conversation
  • bs_send_message() sends a message to a conversation
  • bs_delete_message_for_self() hides a message for you
  • bs_leave_convo() leaves a conversation
  • bs_get_convo_availability() retrieves info on if you can chat with another actor
  • bs_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 embed for bs_get_posts() (#40, #41).
  • Include all returned information in bs_get_author_feed(). Note that this requires adding a prefix to reply and reason information. (#43)

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 4.2 min · r-oldrel-macos-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 0.4.0
READMEYes · 288 wordsVignettesYes · 3 · dynamicNEWSYes · 100% structured · mentions 0.4.0Citation fileYes · software entry onlyWebsiteYes · pkgdown
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

10.9K
CRAN downloads in the past year
Rank #4,157 · ~30/day · ~910/mo
Daily download trend is not available in this view yet.
69230 days
2.2K90 days
10.9K1 year
Compare downloads with other packages →
Also on1.1K r2u14 autocran

Repository

34Stars
9Forks
5Open issues
1Open PRs
5Releases
361Commits
5Commit identities
blueskyratprotoatprotocolbluesky-apibskysocial-media
361 commits · Last activity 2026-07-01 · 0% stars, 30d · Default branch at 0.5.0, ahead of CRAN 0.4.0 (checked 2026-10-22)
Responsiveness
How these are sampled
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

2025-08-12 · 272026-08-02 · 34
PracticesBeta

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.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (1)
Contributing guide
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-07-01 · The repository has a site deploy workflow

pkgdown site last built 2026-07-01

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 3 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (1)
cran-comments.md
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
23 external dependencies (excludes base and recommended)

Installing bskyr adds 37 packages (24 with compiled code, 30 MB of source tarballs). Heaviest: stringi 11 MB, magick 4.4 MB, Rcpp 1.8 MB.

Depends (1)
R >= 4.2.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (1)
Author, Maintainer since 0.0.4 (2023)
Releases (6)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 0.4.0Latest
    record
    2025-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
    record
    2025-05-03 · diff ↗ ·
    added 3 exports
    bs_delete_post, bs_get_list_feed, bs_new_embed_external
  • R
    R 4.5.0 released · 2025-04-11
  • 0.2.0
    record
    2025-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
  • R
    R 4.4.0 released · 2024-04-24
  • 0.1.2
    record
    2024-01-09 · diff ↗ ·
    added 1 export
    bs_search_posts
  • 0.1.0
    record
    2023-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.4
    record
    2023-11-10
  • R
    R 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
Appears in task views

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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for bskyr version 0.4.0 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy