Search and the API

Site and network search, autocomplete, feeds, and the public JSON API.

Every site with a search route gets full-text search over its published entities, with facets and filters from the schema's search declarations.

Scope

A search route's config scope is "site" (default) or "network". Network scope searches every discoverable Ransack site — active, crawl-open, published content only — with results attributed to their site and linked absolutely. Visitors can flip between "This site" and "Everywhere" on any search page; the config only sets the default.

Autocomplete

GET /api/v1/suggest?q=<prefix>&scope=site|network returns up to five suggestions. In network scope, matching sites rank first — typing a site's name jumps you there. Every search box upgrades to this automatically; Enter always submits your raw query unless you actively pick a suggestion.

Machine surfaces

Per site: robots.txt honoring the crawl policy, sitemap.xml, a site Atom feed, a per-list-route Atom feed at <path>/feed.xml, canonical and Open Graph metadata, and JSON for every page (?format=json). The JSON mirrors the page exactly — including what it excludes: search_text content never appears on any public surface.