> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-fix-google-validation-docs-404s.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VastAI.search_offers

Search for offers based on various criteria.

## Signature

```python theme={null}
VastAI.search_offers(
    type: Optional[str] = None,
    no_default: bool = False,
    new: bool = False,
    limit: Optional[int] = None,
    disable_bundling: bool = False,
    storage: Optional[float] = None,
    order: Optional[str] = None,
    query: Optional[str] = None
) -> str
```

## Parameters

<ParamField path="type" type="Optional[str]">
  Instance type filter: 'bid' for interruptible, 'reserved' for reserved, 'on-demand' for on-demand.
</ParamField>

<ParamField path="no_default" type="bool" default="False">
  Disable the default query filters (external=false rentable=true verified=true).
</ParamField>

<ParamField path="new" type="bool" default="False">
  Use the new search algorithm (experimental).
</ParamField>

<ParamField path="limit" type="Optional[int]">
  Maximum number of results to return.
</ParamField>

<ParamField path="disable_bundling" type="bool" default="False">
  Disable offer bundling (show individual machine slots).
</ParamField>

<ParamField path="storage" type="Optional[float]">
  Amount of storage in GiB to include in pricing calculations.
</ParamField>

<ParamField path="order" type="Optional[str]">
  Comma-separated list of fields to sort on; append '-' to sort descending (e.g. "score-").
</ParamField>

<ParamField path="query" type="Optional[str]">
  Search query string (e.g. "gpu\_name=RTX\_4090 num\_gpus>=2 rentable=True").
</ParamField>

## Returns

`str`, Result from the API call.

## Example

```python theme={null}
from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.search_offers()
print(result)
```