bs_search_posts: Find posts matching search criteria

In bskyr: Interact with 'Bluesky' Social

Find posts matching search criteria

Description

Find posts matching search criteria

Usage

bs_search_posts(
  query,
  sort = NULL,
  since = NULL,
  until = NULL,
  mentions = NULL,
  author = NULL,
  lang = NULL,
  domain = NULL,
  url = NULL,
  tag = NULL,
  cursor = NULL,
  limit = NULL,
  user = get_bluesky_user(),
  pass = get_bluesky_pass(),
  auth = bs_auth(user, pass),
  clean = TRUE
)

Arguments

query	Character vector, length 1. character. Search query, Lucene query syntax is recommended.
sort	character. Order or results. Either 'top' or 'latest'
since	character. Filter results for posts on or after the indicated datetime or ISO date (YYYY-MM-DD).
until	character. Filter results for posts before the indicated datetime or ISO date (YYYY-MM-DD).
mentions	character. Filter to posts which mention the given account.
author	character. Filter to posts by the given account.
lang	character. Filter to posts in the given language.
domain	character. Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.
url	character. Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.
tag	character. Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'AND' matching.
cursor	Character, length 1. A cursor property from a prior response. Default: NULL.
limit	Integer. Number of records to request. If over 100, multiple requests are made.
user	Character. User name to log in with. Defaults to get_bluesky_user().
pass	Character. App password to log in with. Defaults to get_bluesky_pass().
auth	Authentication information. Defaults to bs_auth(user, pass).
clean	Logical. Should output be cleaned into a tibble? Default: TRUE.

Value

a tibble::tibble of suggested accounts to follow

Lexicon references

feed/searchPosts.json (2024-11-25)

Function introduced

v0.1.1 (2023-12-13)

Examples

bs_search_posts('redistricting')
bs_search_posts('ggplot2', tag = 'rstats', sort = 'latest')

bskyr documentation built on June 8, 2025, 10:33 a.m.