Browser SDK

A typed JavaScript client for AACsearch. Single search, federated multi-search, facets — under 50ms p99.

Search from the browser

NPM package. TypeScript types. Works in React, Vue, Svelte, Astro, or plain JS. No backend proxy required.

Autocomplete on every method. No guessing response shapes. Types ship with the package — no @types/ needed.

search(indexSlug, query, options) → typed results. Facets, filters, sort, pagination — all in the options object.

multiSearch([...queries]) → typed results array. One HTTP request, parallel execution, independent facets.

Initialise with a short-lived scoped token from your server. The SDK attaches it automatically to every request.

Typed error objects with slug (search_failed, quota_exceeded, rate_limited). Catch and handle programmatically.

Tree-shakeable ESM build. Only the methods you import are bundled. No runtime dependencies.

Add AACsearch to your website with a few lines of JavaScript.

1
Step 1
Install the package
Install the AACsearch Browser SDK from npm. npm install @aacsearch/browser-sdk
2
Step 2
Initialize the client
Create a client with your scoped token. import { AACSearchClient } from '@aacsearch/browser-sdk'; const client = new AACSearchClient({ token: 'ss_scoped_...' });
3
Step 3
Run a search
Call search() from your frontend code. const results = await client.search({ q: 'shoes', limit: 10 }); console.log(results.hits);

Create an index, add documents and connect search from your app. Free tier covers a prototype — data persists when you upgrade.