gotosocial/docs/user_guide/search.md

# Search

## Query formats

GotoSocial accepts several kinds of search query:

- `@username`: search for an account with the given username on any domain. Can return multiple results.
- `@username@domain`: search for a remote account with exact username and domain. Will only ever return 1 result at most.
- `https://example.org/some/arbitrary/url`: search for an account or post with the given URL. If the account or post hasn't already federated to GotoSocial, it will try to retrieve it. Will only ever return 1 result at most.
- `#hashtag_name`: search for a hashtag with the given hashtag name, or starting with the given hashtag name. Case insensitive. Can return multiple results.
- `any arbitrary text`: search for posts containing the text, hashtags containing the text, and accounts with usernames, display names, or bios containing the text, exactly as written. Both posts you've written as well as posts replying to you will be searched. Account bios will only be searched for accounts that you follow. Can return multiple results.

## Search operators

Arbitrary text queries may include the following search operators:

- `from:username`: restrict results to statuses created by the specified *local* account.
- `from:username@domain`: restrict results to statuses created by the specified remote account.

For example, you can search for `sloth from:yourusername` to find your own posts about sloths.
[feature] Add from: search operator and account_id query param (#2943) * Add from: search operator * Fix whitespace in Swagger YAML comment * Move query parsing into its own method * Document search * Clarify post search scope 2024-05-31 10:57:42 +00:00			`# Search`

			`## Query formats`

			`GotoSocial accepts several kinds of search query:`

			- `@username`: search for an account with the given username on any domain. Can return multiple results.
			- `@username@domain`: search for a remote account with exact username and domain. Will only ever return 1 result at most.
			- `https://example.org/some/arbitrary/url`: search for an account or post with the given URL. If the account or post hasn't already federated to GotoSocial, it will try to retrieve it. Will only ever return 1 result at most.
			- `#hashtag_name`: search for a hashtag with the given hashtag name, or starting with the given hashtag name. Case insensitive. Can return multiple results.
			- `any arbitrary text`: search for posts containing the text, hashtags containing the text, and accounts with usernames, display names, or bios containing the text, exactly as written. Both posts you've written as well as posts replying to you will be searched. Account bios will only be searched for accounts that you follow. Can return multiple results.

			`## Search operators`

			`Arbitrary text queries may include the following search operators:`

			- `from:username`: restrict results to statuses created by the specified local account.
			- `from:username@domain`: restrict results to statuses created by the specified remote account.

			For example, you can search for `sloth from:yourusername` to find your own posts about sloths.