> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videodb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search V2 & Ask

> High-level search, DeepSearch, direct semantic search, structured query, aggregation, Ask, and legacy search.

VideoDB Search V2 separates intelligent search from direct retrieval methods.

| Capability                     | Video endpoint                            | Collection endpoint                                 | Python SDK                                    |
| ------------------------------ | ----------------------------------------- | --------------------------------------------------- | --------------------------------------------- |
| High-level search / DeepSearch | `POST /video/{video_id}/search/v2/`       | `POST /collection/{collection_id}/search/v2/`       | `video.search(...)`, `collection.search(...)` |
| Semantic search                | `POST /video/{video_id}/semantic-search/` | `POST /collection/{collection_id}/semantic-search/` | `semantic_search(...)`                        |
| Structured query               | `POST /video/{video_id}/query/`           | `POST /collection/{collection_id}/query/`           | `query(...)`                                  |
| Aggregation                    | `POST /video/{video_id}/aggregate/`       | `POST /collection/{collection_id}/aggregate/`       | `aggregate(...)`                              |
| Ask                            | `POST /video/{video_id}/ask/`             | `POST /collection/{collection_id}/ask/`             | `ask(...)`                                    |
| Legacy search                  | `POST /video/{video_id}/search/`          | `POST /collection/{collection_id}/search/`          | `legacy_search(...)`                          |

<CardGroup cols={2}>
  <Card icon="search" title="High-level Search & DeepSearch" href="/api-reference/search-v2/search">
    Natural-language retrieval and DeepSearch sessions.
  </Card>

  <Card icon="search" title="Semantic Search" href="/api-reference/search-v2/semantic-search">
    Direct vector search over semantic indexes.
  </Card>

  <Card icon="filter" title="Query" href="/api-reference/search-v2/query">
    Structured filters over one queryable index.
  </Card>

  <Card icon="chart-bar" title="Aggregate" href="/api-reference/search-v2/aggregate">
    Counts, groups, facets, and metrics.
  </Card>

  <Card icon="message-square" title="Ask" href="/api-reference/search-v2/ask">
    Answer questions using retrieved video context.
  </Card>

  <Card icon="history" title="Legacy Search" href="/api-reference/search-v2/legacy-search">
    Older spoken-word and scene-index search behavior.
  </Card>
</CardGroup>