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.

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}/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.

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

OpenAPI Specification

algolia-composition-api-openapi.yml Raw ↑
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