get_timeline_hashtag {rtoot} | R Documentation |
Get hashtag timeline
Description
Query the instance for the timeline of a specific hashtag
Usage
get_timeline_hashtag(
hashtag = "rstats",
local = FALSE,
only_media = FALSE,
max_id,
since_id,
min_id,
limit = 20L,
instance = NULL,
token = NULL,
anonymous = FALSE,
parse = TRUE,
retryonratelimit = TRUE,
verbose = TRUE
)
Arguments
hashtag |
character, Content of a #hashtag. The hash is optional |
local |
logical, Show only local statuses? |
only_media |
logical, Show only statuses with media attached? |
max_id |
character or |
since_id |
character or |
min_id |
character or |
limit |
integer, Maximum number of results to return |
instance |
character, the server name of the instance where the status is located. If |
token |
user bearer token (read from file by default) |
anonymous |
some API calls do not need a token. Setting anonymous to TRUE allows to make an anonymous call if possible. |
parse |
logical, if |
retryonratelimit |
If TRUE, and a rate limit is exhausted, will wait until it refreshes. Most Mastodon rate limits refresh every 5 minutes. If FALSE, and the rate limit is exceeded, the function will terminate early with a warning; you'll still get back all results received up to that point. |
verbose |
logical whether to display messages |
Details
max_id
, since_id
, and min_id
can either be character or POSIXct
(date time). If it is POSXIct
, it will be converted to the so-called snowflake ID.
Value
statuses
References
https://docs.joinmastodon.org/methods/timelines/
Examples
## Not run:
get_timeline_hashtag(hashtag = "#ichbinhanna")
## anonymously
get_timeline_hashtag(hashtag = "ichbinhanna", instance = "mastodon.social", anonymous = TRUE)
## Search for toots by date
get_timeline_hashtag(hashtag = "ichbinhanna", instance = "mastodon.social", anonymous = TRUE,
max_id = as.POSIXct("2024-03-01"))
## End(Not run)