Introduction
Overview of the PSYKHE AI APIs.
PSYKHE AI exposes three APIs that work together to deliver real-time, taste-driven personalization across your storefront.
The Three APIs
Ingestion API
Keep PSYKHE AI in sync with your catalog. Supports full and incremental sync modes for products. Use this to onboard your catalog and push ongoing updates.
Tracking API
Capture visitor behaviour - PDP views, list views, clicks, add-to-cart, transactions, dwell time, and more - through the Snowplow browser plugin. These events build the per-visitor taste profile that powers ranking.
→ Tracking API Getting Started
Recommendation API
Request personalized product rankings for Browse (PLP), Search, and Carousel
surfaces. Works for anonymous (NLI) and logged-in (LI) users, and adapts as the
session evolves.
How They Work Together
- Ingestion API loads and updates your catalog in PSYKHE AI.
- Tracking API streams visitor behaviour from the storefront.
- Recommendation API returns ranked products using both, in real time.
Getting Started
- Recommendation API Authentication - public and private key usage.
- Quick Start - end-to-end integration walkthrough.