Bluesky Actor

An Apify actor for retrieving data from the social network Bluesky. It can fetch posts, account profiles, followers, and follows.

Key Features

• Get Posts: Fetch posts from a specific account. The account handle must be exact (e.g., washingtonpost.com).
• Search for Posts: Find posts matching a text query. Supports standard filters or advanced Lucene query syntax (recommended). Example: from:washingtonpost.com lang:en since:2024-11-10 "airbnb".
• Get Followers/Follows: Retrieve the list of accounts following a user, or the accounts a user follows.
• Get Account Profile: Fetch detailed information for a specific account.
• Search for Accounts: Find account names matching a query.

How to Use

Choose an operation (like "Search for Posts") and provide the necessary input, such as an account handle or search query.

• For searching: Using Lucene syntax in the query field often yields better results than separate filter fields. This syntax overrides other filters except for 'Posts type' and 'Sorting'. Refer to the official syntax guide: https://bsky.social/about/blog/05-31-2024-search.
• Date Filter Notes:
  • In "Get Posts," the since filter only works if a matching post is found before hitting the maximum post limit.
  • In "Search for Posts" (without Lucene), dates use UTC timezone and are set to 23:59:59.
• Always use a proxy for reliable operation.

Input / Output

Main Inputs:
* Operation: Select the function to perform (e.g., Search for Posts).
* Query/Account Handle: The search term or exact Bluesky account identifier.
* Filters: Language, dates, etc. (largely overridden by Lucene queries).
* Max Items: Limits results (max 100 posts for searches).

Output:
The actor returns structured JSON data. The structure varies by operation:
* Posts: Contains post text, author, engagement metrics, and timestamps.
* Accounts/Profiles: Contains account handles, display names, descriptions, and follower counts.
* Followers/Follows: Lists account identifiers.

Limitations

Bluesky's search is under active development and filters may not always be respected precisely. For example, searching for "plane" with a language filter set to "Spanish" might still return English posts. Using language-specific keywords within a Lucene query (e.g., lang:es "avion") works more reliably.

Search for Posts does not support pagination and is limited to a maximum of 100 posts per run.

Support

For bug reports, please open a new issue and include your Run URL and Input configuration.