---
name: intelligent-search-api
description: "Intelligent Search API skill. Use when working with Intelligent Search for top_searches, autocomplete_suggestions, correction_search. Covers 8 endpoints."
version: 1.0.0
generator: lapsh
---

# Intelligent Search API
API version: 0.1.12

## Auth
No authentication required.

## Base URL
https://apiexamples.vtexcommercestable.com.br/api/io/_v/api/intelligent-search

## Setup
1. No auth setup needed
2. GET /top_searches -- verify access

## Endpoints

8 endpoints across 8 groups. See references/api-spec.lap for full details.

### top_searches
| Method | Path | Description |
|--------|------|-------------|
| GET | /top_searches | Get list of the 10 most searched terms |

### autocomplete_suggestions
| Method | Path | Description |
|--------|------|-------------|
| GET | /autocomplete_suggestions | Get list of suggested terms and attributes similar to the search term |

### correction_search
| Method | Path | Description |
|--------|------|-------------|
| GET | /correction_search | Get attempt of correction of a misspelled term |

### banners
| Method | Path | Description |
|--------|------|-------------|
| GET | /banners/{facets} | Get list of banners registered for query |

### search_suggestions
| Method | Path | Description |
|--------|------|-------------|
| GET | /search_suggestions | Get list of suggested terms similar to the search term |

### product_search
| Method | Path | Description |
|--------|------|-------------|
| GET | /product_search/{facets} | Get list of products for a query |

### facets
| Method | Path | Description |
|--------|------|-------------|
| GET | /facets/{facets} | Get list of the possible facets for a given query |

### pickup-point-availability
| Method | Path | Description |
|--------|------|-------------|
| GET | /pickup-point-availability/{facets} | Get pickup point availability for Delivery Promise |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all top_searches?" -> GET /top_searches
- "Search autocomplete_suggestions?" -> GET /autocomplete_suggestions
- "Search correction_search?" -> GET /correction_search
- "Search banners?" -> GET /banners/{facets}
- "Search search_suggestions?" -> GET /search_suggestions
- "Search product_search?" -> GET /product_search/{facets}
- "Search facets?" -> GET /facets/{facets}
- "Search pickup-point-availability?" -> GET /pickup-point-availability/{facets}

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params

## CLI

```bash
# Update this spec to the latest version
npx @lap-platform/lapsh get intelligent-search-api -o references/api-spec.lap

# Search for related APIs
npx @lap-platform/lapsh search intelligent-search-api
```

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)