---
description: searching for an available Vtuber Fandom page
---

# search()

```python
Vwiki().search(vtuber: str, limit: int = 10)

#or

AioVwiki().search(vtuber: str, limit: int = 10)
```

<details>

<summary>Parameters</summary>

* **vtuber** (_<mark style="color:blue;">str</mark>_) - the vtuber's fandom page to search for
* **limit** (_<mark style="color:yellow;">int</mark>_) - limit of the search results (_max: <mark style="color:yellow;">10</mark>_)

</details>

{% hint style="info" %}
**Note**: `vtuber` query will always get auto-corrected when calling `search()`
{% endhint %}

<details>

<summary>Returns</summary>

_<mark style="color:purple;">list</mark>_ - list of relevant searches

</details>

{% hint style="info" %}
**Note**: will returns `[]` if there is no relevant results within the search limit
{% endhint %}

## Use Case

{% tabs %}
{% tab title="Async (non-blocking)" %}
Without `auto_correct` :

```python
from vtuberwiki import AioVwiki
import asyncio

async def search_page():
    async with AioVwiki() as aio_vwiki:
        s = await aio_vwiki.search(vtuber="mythia batford",limit=3)
        print(s) # ['Mythia Batford', 'Mythia Batford/Gallery', 'Mythia Batford/Discography']

asyncio.run(search_page()
```

{% hint style="info" %}
**Note**: the most relevant search is usually the **first index**
{% endhint %}
{% endtab %}

{% tab title="Sync (blocking)" %}
Without `auto_correct` :

```python
from vtuberwiki import Vwiki

def search_page():
    vwiki = Vwiki()
    s = vwiki.search(vtuber="mythia batford",limit=3)
    print(s) # ['Mythia Batford', 'Mythia Batford/Gallery', 'Mythia Batford/Discography']

search_page()
```
{% endtab %}
{% endtabs %}
