headless-intelligent-search

Call VTEX Intelligent Search endpoints directly from headless storefronts.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtexdocs/ai-skills --skill headless-intelligent-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headless-intelligent-search
Source: https://github.com/vtexdocs/ai-skills/tree/main/tracks/headless/skills/headless-intelligent-search
Command: npx skills add https://github.com/vtexdocs/ai-skills --skill headless-intelligent-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline the integration of VTEX Intelligent Search into a headless storefront by linking frontend calls directly to search endpoints and automating analytics events, enabling accurate product discovery and ranking without backend proxies.

Core Features & Use Cases

  • Frontend integration with Intelligent Search API endpoints: product_search, autocomplete_suggestions, facets, banners, correction_search, and top_searches.
  • Analytics event collection to feed Intelligent Search ranking and insights.
  • Use Case: Build a responsive search page with faceting, autocomplete, and real-time analytics in your headless storefront.

Quick Start

Integrate the Intelligent Search frontend calls directly, wire analytics events, and render results using your headless storefront.

Frequently Asked Questions about headless-intelligent-search

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

FAQPage Schema
How do I implement headless search with VTEX Intelligent Search directly from the frontend?

Implement headless search by calling VTEX Intelligent Search API endpoints like product_search, autocomplete_suggestions, and facets directly from your client, bypassing backend proxies for real-time product discovery.

What endpoints are available for VTEX Intelligent Search frontend integration?

Available endpoints include product_search, autocomplete_suggestions, facets, banners, correction_search, and top_searches, covering the complete headless storefront search experience from discovery to ranking.

Do I need a BFF proxy to use VTEX Intelligent Search in a headless storefront?

No BFF proxy is needed. Frontend teams integrate VTEX Intelligent Search directly from the client to enable real-time discovery, accurate product ranking, and analytics without backend intermediary layers.

How do analytics events work with VTEX Intelligent Search in a headless setup?

Analytics events must be sent to the Intelligent Search Events API after search results render, feeding ranking algorithms and insights to continuously improve product discovery accuracy and search relevance.

What are the required parameters for VTEX Intelligent Search API requests?

Requests must include locale and pagination via from/to parameters, ensuring proper localization and controlled result paging for product_search, facets, and autocomplete_suggestions endpoints.

Can I build autocomplete and faceting for a headless storefront using VTEX Intelligent Search?

Yes, VTEX Intelligent Search provides autocomplete_suggestions and facets endpoints that enable responsive search pages with real-time product discovery, faceted navigation, and autocomplete functionality in headless storefronts.