Skip to main content

Documentation

Using Uruky as an API

How to fetch JSON search results from /search and /image-search with f=json and an incognito token.

Uruky does not expose a separate REST API. Authenticated GET requests to /search and /image-search with f=json return application/json instead of the usual HTML page. The same account settings, filters, rate limits, and billing apply as in the browser UI.

Authentication

For scripts and non-browser clients, pass your incognito token as the i query parameter so you do not need a session cookie. Generate, rotate, or delete the token under Settings. A normal logged-in session cookie also works, but is awkward for automation. Treat the token like a password and do not share it.

Examples

Web search: 

curl "https://uruky.com/search?q=privacy+search&f=json&i=YOUR_INCOGNITO_TOKEN"

Image search: 

curl "https://uruky.com/image-search?q=cats&f=json&i=YOUR_INCOGNITO_TOKEN"

JSON response (web search)

Top-level fields:

  • results Array of result objects for the current page.
  • totalResults Estimated total number of matching results.
  • page Current page number (1-based).
  • pageCount Total number of pages available for this query.
  • removedMaliciousCount How many results were removed by malicious-domain filtering on this response.
  • removedAiSlopCount How many results were removed by AI-slop filtering on this response.
  • elapsedMs Optional. Search latency in milliseconds when available.

Each item in results may include:

  • url Result URL (after URL rewrites and UTM stripping, when those settings are enabled).
  • title Result title.
  • description Snippet or description.
  • faviconUrl Optional favicon URL.
  • date Optional publication or crawl date.
  • providers Optional list of providers that returned this result.

JSON response (image search)

The response envelope matches web search ( results , totalResults , page , pageCount , filter counts, optional elapsedMs ).

Each image result may include:

  • imageUrl Full image URL, served via /image-proxy (includes i when the request used an incognito token).
  • thumbnailUrl Thumbnail URL, also via /image-proxy .
  • sourceUrl Page that hosts the image (after URL rewrites and UTM stripping when enabled).
  • title Image title or alt text.
  • date Optional date.
  • width / height Optional dimensions in pixels.
  • credit Optional attribution string.
  • provider Image search provider that returned this result.

Controlling results

In-query operators (for example site: , file: , quoted phrases, exclusions) and URL query parameters ( p , l , c , w , sp , mr , sr , and others) work the same for JSON responses as for HTML. See Search operators and query parameters for the full list.

Related