Query Suggestions API client

The Query Suggestions API client is part of the algoliasearch package. You can install this package with pip:

1
pip install 'algoliasearch>=4,<5'

To use the Query Suggestions client, add this import to your files:

1
2
from algoliasearch.query_suggestions.client import QuerySuggestionsClientSync
from json import loads

To create an instance of the client:

1
2
3
4
# In an asynchronous context, you can use QuerySuggestionsClient instead, which exposes the exact same methods.
client = QuerySuggestionsClientSync(
    "ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION"
)

Replace ALGOLIA_APPLICATION_ID_REGION with your Algolia application’s analytics region: us for the United States or eu for Europe. You can check your analytics region in the Infrastructure > Analytics section of the Algolia dashboard.

Async code

To use the Query Suggestions client in async environments, add these imports instead:

1
2
import asyncio
from algoliasearch.query_suggestions.client import QuerySuggestionsClient

The client supports the async with statement to automatically close open connections.

1
2
3
async def run():
    async with QuerySuggestionsClient(ALGOLIA_APPLICATION_ID, ALGOLIA_API_KEY) as client:
        # client.search(...)

The method names are the same for synchronous and asynchronous methods.

List of methods

Each method makes one request to the Query Suggestions API.

Configurations

Logs