> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tattoo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

# Search

Search is the first real consumer of the ontology-first model.

## Current Scope

The current runtime `GET /search` can search across:

* studios
* artists
* designs

This route is live as authenticated discovery beta. It requires WorkOS auth plus a mapped TattooAPI actor, not public no-auth access.

## Why Search Matters First

Search is where ontology quality becomes visible fastest:

* style taxonomy quality affects filtering
* entity normalization affects ranking
* trust metadata affects what should surface publicly
* provenance affects how aggressive agents can be with downstream use

## Current Query Surface

The runtime currently supports:

* `q`
* `type`
* `city`, `state`, `country`
* `latitude`, `longitude`, `radius`
* `styles`, `specialties`
* `min_rating`
* `verified_only`
* `page`, `limit`
* `sort_by`, `sort_order`
* `include_facets`

## What Improves Next

* style filters become ontology-backed instead of freeform strings
* search results gain clearer provenance and trust envelopes
* curated and verified records rank above raw and merely normalized records
* future agent tools consume the same search contracts instead of reverse-engineering them