SkySearch User Guide
SkySearch lets you easily search and analyze Bluesky posts. This guide covers everything from basic usage to advanced tips.
Table of Contents
1. Basic Search
Search by User ID
To view all posts from a specific user, enter their Bluesky handle in the "User ID" field.
Enter the handle in the "User ID" field (e.g., bsky.app).
The "@" prefix is handled automatically, so you can include it or not.
Click the "Search" button.
The user's profile and posts will be displayed.
Search by Keyword
To find posts containing specific keywords across all of Bluesky, use the "Keyword" field.
- Keyword only: Searches all public Bluesky posts
- User ID + Keyword: Filters that user's posts by the keyword
2. Filters
Date Range
Narrow results to a specific time period.
- From: Show posts after this date
- To: Show posts before this date
- You can specify just one date (e.g., only "From" to get all posts since that date)
Minimum Likes
Set a minimum like count to only show popular posts. Great for finding viral content.
Media Only
Check "Media only" to show only posts with images or videos attached.
Exclude Replies
Check "Exclude replies" to hide reply posts and show only original posts. Useful when you want to browse a user's own original content without conversation threads.
3. Sorting
Choose a sort order in the search form before searching, or switch between orders at any time using the buttons shown above the results.
| Sort Order | Description | Best For |
|---|---|---|
| Newest | Most recent posts first | Following latest updates |
| Oldest | Oldest posts first | Reading posts chronologically |
| Most liked | Highest like count first | Finding popular posts |
4. Statistics
Statistics are shown above the search results:
| Metric | Description |
|---|---|
| Total | Number of posts matching your search |
| Avg Likes | Average likes per post |
| Max Likes | Highest like count among results |
| Avg Reposts | Average reposts per post |
5. Search History
Your search conditions are automatically saved for quick re-use.
- Up to 10 searches are saved
- 3 shown initially, click "Show more" to see all
- Click a history chip to re-run that search
- Click "x" to remove individual entries, or "Clear all" to remove everything
- History is stored in your browser only — never sent to any server
6. Dark Mode
Click the sun/moon icon in the top-right corner to toggle between light and dark mode. Your preference is saved automatically.
7. Trending
The "Trending" tab shows you what topics are buzzing on Bluesky right now.
- A list of trending keywords is fetched and displayed automatically
- Click any topic to instantly search for posts about it
- Great for staying on top of what the Bluesky community is talking about
8. Post Analytics
The "Analytics" tab lets you collect all of a user's posts and visualize their activity patterns and engagement.
| Metric | Description |
|---|---|
| Total / Avg Likes | Posts analyzed and average likes per post |
| Max Likes | Highest like count among all posts |
| Peak Hour | Hour of day with the most posts (0–23) |
| Hourly / Weekly charts | Post volume distribution by hour and weekday |
| Top 5 Posts | Most liked posts from the dataset |
Just enter a User ID and click "Analyze" — data is collected and visualized automatically.
9. Tips & Tricks
Find a user's best posts
Enter a User ID, sort by "Most liked", and set a minimum like count to quickly discover their most popular content.
Track a trending topic
Search by keyword with "Newest" sort and a date range to see how a topic evolved over time.
Understand posting patterns
Use the Analytics tab to see when a user is most active. Useful for finding the best time to post, or understanding an influencer's habits.
Browse media posts
Check "Media only" to filter for image and video posts — great for browsing artwork or photography.
Add to home screen
SkySearch is a Progressive Web App (PWA). On mobile, tap "Add to Home Screen" in your browser menu to launch it like a native app. On desktop Chrome, use the install button in the address bar to add it as a desktop app.
10. FAQ
Q. Is SkySearch free?
A. Yes, SkySearch is completely free. No account registration required.
Q. Do I need a Bluesky account?
A. No. SkySearch uses Bluesky's public API, so no login is needed.
Q. Why are there few results?
A. Click "Load more" to fetch additional posts. Removing filters may also show more results.
Q. Can I search private accounts?
A. No, only publicly available posts can be searched.
Q. Is my search history visible to others?
A. No. History is stored only in your browser's local storage and is never sent externally.
Q. Does it work on mobile?
A. Yes, SkySearch is fully responsive and works on phones and tablets.