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

# Quickstart

> Create a key, make a call, read the limits.

<Steps>
  <Step title="Create a key">
    Sign in at [truckaurbus.com](https://next.truckaurbus.com/en/account) (email link or Google), open **API keys**, name the key. The secret `tab_live_…` is shown once.
  </Step>

  <Step title="Call the API">
    ```bash theme={"system"}
    curl "https://api.truckaurbus.com/v1/variants?q=tipper&price_max=4000000" \
      -H "Authorization: Bearer tab_live_..."
    ```
  </Step>

  <Step title="Read the headers">
    `X-RateLimit-Limit`, `X-RateLimit-Used` and `X-RateLimit-Burst` tell you where you stand; `X-Request-Id` identifies the call if you write to us.
  </Step>
</Steps>

```python Python theme={"system"}
pip install truckaurbus

from truckaurbus import Truckaurbus
tab = Truckaurbus("tab_live_...")
hits = tab.variants.search(q="12 tyre tipper", price_max=4_000_000)["hits"]
```

```ts TypeScript theme={"system"}
npm install truckaurbus

import { Truckaurbus } from "truckaurbus";
const tab = new Truckaurbus("tab_live_...");
const { hits } = await tab.variants.search({ q: "12 tyre tipper", price_max: 4_000_000 });
```