---
title: "Autocomplete"
method: GET
path: "/v3/autocomplete"
tags: ["Miscellaneous"]
---

# Autocomplete

`GET /v3/autocomplete`

This endpoint returns autocomplete suggestions for search keywords, businesses, and categories based on the input text.

## Query parameters

- `text` string, required
- `locale` string
- `latitude` number
- `longitude` number

## Response `200`

Autocomplete data returned.

- object
  - `categories` object[], required — List of categories matching the search term
    - `alias` string, required — Alias of a category, when searching for business in certain categories, use alias rather than the title.
    - `title` string, required — Title of a category for display purpose.
  - `businesses` object[], required — List of businesses Id and Name matching the search term
    - `id` string, required — Yelp Encrypted Business ID.
    - `name` string, required — Business name
  - `terms` object[], required
    - `text` string, required

## Other responses

- `400` — Bad Request. Message varies depending on failure scenario
- `401` — The API key has either expired or doesn't have the required scopes to query this endpoint. | code | description | | ------------- | ------------- | | UNAUTHORIZED_API_KEY | The API key provided is not currently able to query this endpoint. | | TOKEN_INVALID | Invalid API key or authorization header. |
- `403` — The API key provided is not currently able to query this endpoint.
- `404` — Resource Not Found
- `413` — The length of the request exceeded the maximum allowed
- `429` — You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)