Algolia

Algolia Composition API

Composes multiple search sources into one curated result set - smart groups, curated queries and composition rules - so a single request returns a merchandised, multi-source response.

Documentation GitHub OpenAPI

Operations 20

GET /{path} Send requests to the Algolia REST API #

POST /{path} Send requests to the Algolia REST API #

PUT /{path} Send requests to the Algolia REST API #

DELETE /{path} Send requests to the Algolia REST API #

POST /1/compositions/{compositionID}/run Run a Composition #

POST /1/compositions/{compositionID}/facets/{facetName}/query Search for facet values #

GET /1/compositions List compositions #

GET /1/compositions/{compositionID} Retrieve a composition #

PUT /1/compositions/{compositionID} Update and insert (upsert) a composition #

DELETE /1/compositions/{compositionID} Delete a composition #

POST /1/compositions/*/batch Batch action to multiple compositions #

POST /1/compositions/{compositionID}/sortingStrategy Set or update the "sortingStrategy" configuration for an existing composition #

GET /1/compositions/{compositionID}/rules/{objectID} Retrieve a rule #

PUT /1/compositions/{compositionID}/rules/{objectID} Add or update a composition rule #

DELETE /1/compositions/{compositionID}/rules/{objectID} Delete a Composition Rule #

POST /1/compositions/{compositionID}/rules/batch Create or update or delete composition rules #

POST /1/compositions/{compositionID}/rules/search Search for composition rules #

GET /1/compositions/{compositionID}/task/{taskID} Check task status #

GET /setClientApiKey Switch the API key used to authenticate requests #

GET /waitForCompositionTask Wait for operation to complete #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/algolia-composition-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Composition API
  summary: The Algolia Composition API lets you run composed search requests on your Compositions
  description: '## Client libraries


    Use Algolia''s API clients and libraries to reliably integrate Algolia''s APIs with your apps.'
  version: 1.0.0
servers:
- url: https://{appId}.algolia.net
  variables:
    appId:
      default: ALGOLIA_APPLICATION_ID
- url: https://{appId}-1.algolianet.com
  variables:
    appId:
      default: ALGOLIA_APPLICATION_ID
- url: https://{appId}-2.algolianet.com
  variables:
    appId:
      default: ALGOLIA_APPLICATION_ID
- url: https://{appId}-3.algolianet.com
  variables:
    appId:
      default: ALGOLIA_APPLICATION_ID
- url: https://{appId}-dsn.algolia.net
  variables:
    appId:
      default: ALGOLIA_APPLICATION_ID
security:
- appId: []
  apiKey: []
tags:


# --- truncated at 32 KB (128 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/openapi/algolia-composition-api-openapi.yml