Custom / advanced setup
For power users, custom browsers, or anything that accepts a raw search-engine URL, here are Neuji's exact values. Use the base URL for your region.
The two URLs
| Purpose | URL (US) | URL (UK) |
|---|---|---|
| Search | https://neuji.com/search?q=%s |
https://neuji.co.uk/search?q=%s |
| Suggestions | https://neuji.com/api/autosuggest?q=%s |
https://neuji.co.uk/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. Neuji 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://neuji.com/opensearch.xml (UK: https://neuji.co.uk/opensearch.xml)The descriptor is region-aware and 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 Neuji a shortcut (e.g. neuji). Type the shortcut, press Tab or
Space, then your query, to search Neuji on demand even when it is not your default. The Neuji extensions ship
with the keyword neuji pre-set.
Quick examples
A bare search URL (substitute your encoded query for %s / {searchTerms}):
https://neuji.com/search?q=open+source+searchFetch suggestions for a prefix (returns the OpenSearch JSON array):
curl "https://neuji.com/api/autosuggest?q=quantum"