Custom / advanced setup
For power users, custom browsers, or anything that accepts a raw search-engine URL, here are Suede's exact values.
The two URLs
| Purpose | URL |
|---|---|
| Search | https://suede.io/search?q=%s |
| Suggestions | https://suede.io/api/autosuggest?q=%s |
%sis the query placeholder most browsers use in their "add a search engine" dialog. Some browsers expect{searchTerms}instead (the OpenSearch placeholder); both refer to the same thing: where your query goes.- The search URL is all you need for a basic default engine.
- The suggestions URL is optional. It returns OpenSearch Suggestions JSON
(
application/x-suggestions+json) — the array[query, [completions], [descriptions], [urls]]— so the address bar can show completions as you type. Suede computes these privately, in-memory, from its own corpus; queries are never logged.
OpenSearch descriptor
If your browser reads OpenSearch, point it at the descriptor and it picks up both URLs automatically:
https://suede.io/opensearch.xmlThe descriptor is also advertised from every page's <head> via
<link rel="search" …>, so most browsers discover it on their own — see
Android & auto-discovery.
Keyword / shortcut search
In a Chromium browser you can give Suede a shortcut (e.g. suede). Type the shortcut, press Tab or
Space, then your query, to search Suede on demand even when it is not your default. The Suede extensions ship
with the keyword suede pre-set.
Quick examples
A bare search URL (substitute your encoded query for %s / {searchTerms}):
https://suede.io/search?q=open+source+searchFetch suggestions for a prefix (returns the OpenSearch JSON array):
curl "https://suede.io/api/autosuggest?q=quantum"