# AutoSugges documentation

Publish a list, get a publishable key, and add fast, accessible autocomplete to React, Next.js, JavaScript or Expo — plus the full runtime API reference.

## Getting started

- [AutoSugges documentation](https://docs.autosugges.com/index.md): Publish a list, get a publishable key, and add fast, accessible autocomplete to React, Next.js, JavaScript or Expo — plus the full runtime API reference.

## Integrations

- [Integration guides](https://docs.autosugges.com/integrations.md): Add AutoSugges autocomplete to React, Next.js, plain JavaScript or Expo — the real SDK calls, framework by framework.
- [Add AutoSugges autocomplete to a React app](https://docs.autosugges.com/integrations/react.md): Mount the shipped accessible combobox in a React component — debounce, cancellation, keyboard navigation and ARIA are already wired.
- [Add AutoSugges autocomplete to a Next.js App Router project](https://docs.autosugges.com/integrations/nextjs.md): Keep the input in a Client Component and the page around it a Server Component, so only the interactive part ships JavaScript.
- [Add AutoSugges autocomplete to a plain HTML page](https://docs.autosugges.com/integrations/vanilla-js.md): Mount an accessible autocomplete on an ordinary HTML page from a data attribute, with no framework and no hand-written combobox markup.
- [Add AutoSugges autocomplete to an Expo app](https://docs.autosugges.com/integrations/expo.md): Compose the autocomplete from React Native primitives, with the accessibility semantics supplied by the SDK’s native binding.

## API reference

- [API reference](https://docs.autosugges.com/api-reference.md): The AutoSugges runtime HTTP API — GET /v1/query, GET /v1/bootstrap, POST /v1/selection, and the complete typed error vocabulary, with real curl examples.
- [GET /v1/query — the autocomplete endpoint](https://docs.autosugges.com/api-reference/query.md): Call the runtime directly for pre-ranked autocomplete suggestions — the endpoint every SDK binding calls underneath.
- [GET /v1/bootstrap — session policy and version resolution](https://docs.autosugges.com/api-reference/bootstrap.md): Resolve a publishable key to its list identity, active version hash and effective query policy in one call, before the first query.
- [POST /v1/selection — report which suggestion was chosen](https://docs.autosugges.com/api-reference/selection.md): Tell AutoSugges which suggestion a user picked, so future ranking for that list can improve. Entirely optional and fire-and-forget.
- [Error codes](https://docs.autosugges.com/api-reference/errors.md): Every typed error code the AutoSugges runtime API returns — HTTP status, retry posture, the exact message you receive, and what to do about each.
- [Mint an access token from your server](https://docs.autosugges.com/api-reference/token.md): Exchange a secret key for a one-hour access token on your backend, then query a private list from the browser with it.
- [Call the control-plane API with a secret key](https://docs.autosugges.com/api-reference/control-plane.md): Read and change your workspace’s lists from a server with a secret key: cursor pagination, idempotency keys and If-Match concurrency.
- [API versioning and deprecation](https://docs.autosugges.com/versioning.md): How the AutoSugges API is versioned, what counts as a breaking change, and how long a deprecated endpoint keeps working before it is removed.
- [Changelog](https://docs.autosugges.com/changelog.md): Every AutoSugges release, newest first: what changed for integrators on the runtime API, the SDK and the dashboard, with deprecations called out.

---
Canonical page: https://docs.autosugges.com/