Search¶

Search for statuses, accounts, and hashtags across the Fediverse.

Basic usage¶

taibai search "climate change"

By default taibai searches for all three result types (statuses, accounts, and hashtags) and displays each non-empty set in a Rich table.

Filtering by type¶

Use --type to restrict results to a single category:

taibai search python --type statuses
taibai search python --type accounts
taibai search python --type hashtags

Valid values: statuses, accounts, hashtags, all (default).

Limit¶

Control how many results are returned per type (default: 20):

taibai search "open source" --limit 5

Remote WebFinger resolution¶

By default taibai only returns accounts already known to your home instance. Pass --resolve to perform a remote WebFinger lookup, which finds accounts on other servers that your instance has not yet encountered:

taibai search user@other.social --resolve

JSON output¶

Dump the combined results as a JSON object with accounts, statuses, and hashtags arrays:

taibai search python --json
taibai search python --type accounts --json | jq '.[].accounts[].acct'

Options reference¶

Option	Short	Default	Description
`QUERY`	—	—	Search query string
`--type`	—	`all`	`statuses`, `accounts`, `hashtags`, or `all`
`--limit`	`-n`	`20`	Maximum results per type
`--resolve`	—	off	Force remote WebFinger lookup
`--json`	—	off	Dump results as JSON
`--profile`	`-p`	`default`	Profile name (`TAIBAI_PROFILE` env var)