Algolia

Algolia Insights API

Inbound event-ingestion API for click, conversion, view and purchase signals that feed Personalization, Recommend, A/B Testing and Analytics. Accepts events; does not emit them, which is why Algolia publishes no AsyncAPI or webhook contract.

GitHub OpenAPI
Business capability
Product Telemetry Instrumentation BC-4280.10

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /{path} Send a custom GET request to the Insights API · Send requests to the Algolia REST API #
Ask an LLM
“Can I call an Insights API endpoint the client library doesn't wrap yet with a raw GET?”
“Is there a generic way to read from an arbitrary Insights API path?”
Tell an agent
Send a raw GET request to the Insights API path {path}.
Call GET on Insights endpoint {path} with query parameters {parameters}.
POST /{path} Send a custom POST request to the Insights API · Send requests to the Algolia REST API #
Ask an LLM
“What's the way to POST to a new Insights API endpoint before the SDK supports it?”
“Can I make a raw POST call to any Insights path?”
Tell an agent
Send a raw POST request to the Insights API path {path}.
POST to Insights endpoint {path} passing query parameters {parameters}.
PUT /{path} Send a custom PUT request to the Insights API · Send requests to the Algolia REST API #
Ask an LLM
“How can I send a PUT to an Insights API path that has no dedicated method?”
“Can I replace something at a custom Insights endpoint using a raw PUT call?”
Tell an agent
Send a raw PUT request to the Insights API path {path}.
Issue a PUT to Insights endpoint {path} with query parameters {parameters}.
DELETE /{path} Send a custom DELETE request to the Insights API · Send requests to the Algolia REST API #
Ask an LLM
“How do I send a raw DELETE to an Insights API path the client doesn't cover?”
“Can I call DELETE on an arbitrary Insights endpoint?”
Tell an agent destructive · confirm first
Send a raw DELETE request to the Insights API path {path}.
Issue a DELETE against Insights endpoint {path} with query parameters {parameters}.
POST /1/events Send click, conversion and view events · Send events #
Ask an LLM
“How do I send click and conversion events from my search UI to Algolia?”
“How many events can I include in one request, and is there a size limit?”
Tell an agent
Send these user events to Insights: {events}.
Push the batch of click and purchase events {events} for analytics and personalization.
DELETE /1/usertokens/{userToken} Delete all events for a user token · Delete user token events #
Ask an LLM
“How can I erase every event recorded for one user, for example for a privacy request?”
“How long does it take for a user token's events to be removed from analytics?”
Tell an agent destructive · confirm first
Delete all events tied to user token {userToken}.
Purge the event history of user {userToken} from Insights metrics and analytics.
GET /setClientApiKey Switch the API key the Insights client uses · Switch the API key used to authenticate requests #
Ask an LLM
“Can I change which API key my Insights client authenticates with without recreating it?”
“Is it possible to rotate the key used for sending events at runtime?”
Tell an agent
Switch the Insights client to authenticate with API key {apiKey}.
Use {apiKey} as the key for subsequent Insights requests.

Documentation

📖
Documentation
https://www.algolia.com/doc/rest-api/insights/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/openapi/algolia-insights-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/json-schema/algolia-events-items-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/json-schema/algolia-events-response-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/algolia/refs/heads/main/overlays/algolia-insights-api-overlay.yaml

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:algolia-insights-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

algolia-insights-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Insights API
  summary: The Insights API lets you collect events related to your search and discovery experience
  description: Events represent user interactions with your app or website.
  version: 1.0.0
servers:
- url: https://insights.{region}.algolia.io
  variables:
    region:
      description: The region where your Algolia application is hosted.
      enum:
      - us
      - de
      default: us
- url: https://insights.algolia.io
security:
- appId: []
  apiKey: []
tags:


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