Index a product catalog into Klevu and enable on-site search with HMAC-authenticated API calls

domain: docs.klevu.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Retrieve your REST API key and REST AUTH key from the Klevu Merchant Center under Store Settings; the REST AUTH key is used to compute the HMAC-SHA384 request signature.
  2. For each catalog batch, build the HMAC-SHA384 signature by concatenating the request timestamp and request body, then sign it with your REST AUTH key. Pass the signature in the X-KLEVU-RESTAPIKEY request header along with the timestamp in X-KLEVU-TIMESTAMP.
  3. Send a POST request to https://indexing-api.ksearchnet.com/v2/batch with the XML (or JSON) catalog payload; Klevu's indexing API is asynchronous and creates a job per call.
  4. Check the job status by polling the returned job ID; once the job completes, your products are indexed and searchable.
  5. To serve on-site search, call the Klevu Search REST API with your JS API key (public, safe for client-side use) and the user's search term; results are returned as JSON.

Known gotchas

Related routes

Authenticate with the project44 API using OAuth 2.0 client credentials and manage token refresh for continuous shipment visibility calls
project44.com · 5 steps · unrated
Set up Coveo for Commerce: authenticate with a search token and issue a product search via the Commerce API
docs.coveo.com · 5 steps · unrated
Authenticate against the TIDAL API using OAuth 2.0 client credentials for server-to-server catalog access, then perform a catalog search
developer.tidal.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans