Tool documentation

How to find posts with Bluesky advanced search

Learn a repeatable way to find Bluesky posts with the search builder, refine dates and authors, copy reusable queries and diagnose missing results.

Find a post with a reusable search

Open the advanced search builder. Start with a distinctive word you remember from the post, then generate the query. The preview shows exactly what will be opened. You can copy it for later or select “Open search on Bluesky” to inspect the results there.

The form builds a query locally; it does not fetch results, monitor an account or upload what you type. Opening the generated link sends its query to Bluesky. You can therefore prepare several searches before deciding which to execute.

Narrow the search gradually

Add one filter at a time, starting with the author if you know who posted. Use the phrase field when the wording matters, and the domain field when you remember the linked website. The language field accepts a two-letter code. These controls generate Bluesky’s documented search operators rather than a separate search index.

For a practical workflow, search for astronomy, inspect the results, then narrow the author or the dates. Avoid enabling every filter immediately: a spelling error in one field can eliminate an otherwise relevant result. The special value me is useful on Bluesky only while signed in there.

Choose dates deliberately

The date inputs use UTC calendar dates, with an end date later than the start. If you are remembering an event late at night in your local timezone, widen the date window before assuming its post is missing. An incorrect date is rejected before a search link is created.

Dates limit the search; they do not turn it into a complete archive. Deleted posts, unavailable accounts, visibility settings and index coverage can affect the results returned by Bluesky.

Reuse and share a precise query

Copy the generated text into Bluesky’s search box or save the generated URL in your own notes. The URL uses an encoded query parameter, so punctuation and non-Latin characters remain part of the search instead of creating extra URL parameters. If you share the URL, its query is visible to recipients; remove any terms you do not want to disclose.

Once you find the post, use the post viewer to inspect its public thread. Copying a search is different from linking to a specific result: the search can return a different set later.

Use the API or MCP

The same pure generator is available in the tools API at GET /api/v1/tools/search-builder?words=astronomy&language=en, and as MCP tool build_bluesky_search. Optional fields mirror the form. The result contains query text and the official search URL; it does not contain search results. One call costs one quota unit.

Troubleshoot and check the source

If the form rejects an entry, remove quotation marks from the phrase field, use handles rather than display names, and enter a domain without a scheme or path. If Bluesky returns no results, remove the narrowest filter and try again. Consult the official Bluesky search guide for the search engine’s syntax, and the privacy policy for this platform’s logging details. Neither query construction nor an indexed result guarantees that every matching post will be found.

Advanced search builder

Find the posts you were looking for.