intro

library(substackR)

If you haven’t set the key, any API call will prompt you to call set_substack_key() first.

Main Functions

Fetches the latest posts.

latest_posts <- get_substack_latest(
  publication_url = "posocap.substack.com",
  limit           = 10,
  offset          = 0
)

Returns a data frame with columns:

Fetches the top (most liked) posts.

top_posts <- get_substack_top("posocap.substack.com", limit = 5)

Searches posts by keyword.

search_results <- get_substack_search(
  publication_url = "posocap.substack.com",
  query           = "data science",
  limit           = 20
)

Retrieves a single post by slug.

single_post <- get_substack_post(
  publication_url = "posocap.substack.com",
  slug            = "your-post-slug"
)

Missing API key → error asking you to run set_substack_key().
HTTP errors (4xx, 5xx, rate limits) → cli::cli_abort() with status code and message.
JSON parsing issues → warning + empty data frame.