Documentation Index
Fetch the complete documentation index at: https://algolia.com/llms.txt
Use this file to discover all available pages before exploring further.
Client libraries
Use Algolia’s API clients and libraries to reliably integrate Algolia’s APIs with your apps. The official API clients are covered by Algolia’s Service Level Agreement. For more information, see Algolia’s ecosystem.Base URLs
Base URLs for the Recommend API:https://{APPLICATION_ID}.algolia.nethttps://{APPLICATION_ID}-dsn.algolia.net. If your subscription includes a Distributed Search Network, this ensures that requests are sent to servers closest to users.
Retry strategy
To guarantee a high availability, implement a retry strategy for all API requests using the URLs of your servers as fallbacks:https://{APPLICATION_ID}-1.algolianet.comhttps://{APPLICATION_ID}-2.algolianet.comhttps://{APPLICATION_ID}-3.algolianet.com
Authentication
Add these headers to authenticate requests:x-algolia-application-id. Your Algolia application ID.x-algolia-api-key. An API key with the necessary permissions to make the request. The required access control list (ACL) to make a request is listed in each endpoint’s reference.
Request format
Request bodies must be JSON objects.Response status and errors
The Recommend API returns JSON responses. Since JSON doesn’t guarantee any specific ordering, don’t rely on the order of attributes in the API response. Successful responses return2xx statuses. Client errors return 4xx statuses. Server errors return 5xx statuses.
Error responses have a message property with more information.
Version
The current version of the Recommend API is version 1, indicated by the/1/ in each endpoint’s URL.