skills.rest
exilonX
exilonXCOMMUNITY
Explore all skills by this author →
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
One-click install
npx skills add https://github.com/exilonX/ap2 --skill headless-intelligent-search-exilonx
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
vtexdocsvtexdocs
39

headless-intelligent-search

Call VTEX Intelligent Search endpoints directly from headless storefronts.

Official
Advanced
vtexvtex
39

headless-intelligent-search

Integrate the VTEX Intelligent Search API into headless storefronts for search, facets, autocomplete, and analytics.

Official
Advanced
janpeterdjanpeterd

tanstack-table

Configure headless TanStack Table logic for sorting, filtering, pagination, and grouping.

Community
Advanced
WilljeanneWilljeanne

headless-intelligent-search

Implement Intelligent Search API endpoints in headless VTEX storefronts.

Community
Advanced