Verified:GitHub

headless-intelligent-search

Integrate VTEX Intelligent Search APIs into headless storefronts for product search and faceted navigation.

Updated Mar 27, 2026

Search Tags:#autocomplete #intelligent search #search analytics #faceted navigation #vtex #headless storefront #pagination operator fuzzy

Ready to run

npx skills add https://github.com/exilonX/ap2 --skill headless-intelligent-search-exilonx

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: headless-intelligent-search
Source: https://github.com/exilonX/ap2/tree/main/.agents/skills/headless-intelligent-search
Command: npx skills add https://github.com/exilonX/ap2 --skill headless-intelligent-search-exilonx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build reliable product discovery in a headless VTEX storefront while keeping search relevance accurate over time through required analytics and correct pagination behavior.

Core Features & Use Cases

Faceted navigation & filtering: Build category browsing with AND/OR rules across facet types (e.g., Red + Nike logic).
Autocomplete & search corrections: Provide real-time suggestions for better query success and handle misspellings gracefully.
Ranking analytics for Intelligent Search: Send required search impression and click events so VTEX ranking can learn from real user behavior.

Quick Start

Implement headless search by calling VTEX Intelligent Search product_search/facets/autocomplete endpoints directly from the storefront and sending required events to the Intelligent Search Events API after results render and when a user clicks a product.

Frequently Asked Questions about headless-intelligent-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I integrate VTEX Intelligent Search into a headless storefront?▼

Integrating VTEX Intelligent Search requires calling product_search, facets, and autocomplete endpoints directly from your frontend, then sending mandatory analytics events to the Intelligent Search Events API.

Why does search ranking degrade in a headless VTEX implementation?▼

Search ranking degrades if you fail to post required analytics events to sp.vtex.com. Sending search impression and click events after results render is mandatory for VTEX Intelligent Search ranking to learn from user behavior.

How do I handle pagination and typo correction for headless search queries?▼

Handle pagination by passing page and locale parameters to the search endpoints while persisting operator and fuzzy settings across pages. Autocomplete endpoints manage real-time suggestions and gracefully handle misspellings for typo correction.

Can I build faceted navigation with AND/OR rules in VTEX Intelligent Search?▼

Yes, you can build faceted navigation with AND/OR rules across different facet types, such as combining Red and Nike filters. This allows complex category browsing logic directly within your headless storefront UI.

Do I need to send analytics events to sp.vtex.com for autocomplete suggestions?▼

Yes, sending analytics events to sp.vtex.com is mandatory for all Intelligent Search features including autocomplete. Failing to post search impression and click events after results render will degrade overall search relevance.