algolia-webhooks-events

name	algolia-webhooks-events
description	Implement Algolia Insights API for click/conversion tracking, search analytics, and real-time event-driven index updates via database change listeners. Trigger: "algolia events", "algolia analytics", "algolia insights", "algolia click tracking", "algolia conversion", "algolia event tracking".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(curl:*)
version	1.7.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","search","algolia"]
compatibility	Designed for Claude Code

Algolia Events & Insights

Overview

Algolia doesn't use traditional webhooks. Instead, it provides the Insights API for sending user behavior events (clicks, conversions, views) back to Algolia, and the Analytics API for reading search performance data. For keeping your index in sync, you build event-driven pipelines from your database to Algolia.

Prerequisites

• algoliasearch v5 installed (Insights client is included)
• Index with records and queryID enabled (for click analytics)
• search-insights npm package for frontend event tracking

Instructions

Examples

The search, Insights, analytics, and database-sync snippets below show the event correlation contract end to end. Preserve the query ID and a stable user token, and route failed source-database events to a retryable queue rather than dropping them.

Step 1: Enable Click Analytics in Search

import { algoliasearch } from 'algoliasearch';

const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!);

// Enable clickAnalytics to get queryID in search results
const { hits, queryID } = await client.searchSingleIndex({
  indexName: 'products',
  searchParams: {
    query: 'running shoes',
    clickAnalytics: true,  // Returns queryID for event correlation
  },
});
// queryID links this search to subsequent click/conversion events

Step 2: Send Click and Conversion Events (Backend)

// The Insights API is built into the algoliasearch client
// Events connect user behavior back to specific search queries


 client.({
  : [{
    : ,
    : ,
    : ,
    : ,        
    : queryID,              
    : [],    
    : [],                
    : .(),
  }],
});


 client.({
  : [{
    : ,
    : ,
    : ,
    : ,
    : queryID,
    : [],
    : .(),
  }],
});


 client.({
  : [{
    : ,
    : ,
    : ,
    : ,
    : [],
    : .(),
  }],
});