**06** Методы

# Расход квоты по рынкам

`GET /v1/usage`

Тариф, срок и сколько квоты потрачено — всего и по рынкам. Бесплатно: удобно звать перед большой выгрузкой.

Примеры запросов

## Параметры

У этого запроса параметров нет.

## Запрос `GET`

GET

https://

api.apiauto.space/

v1/

usage

cURL:

```bash
curl -s "https://api.apiauto.space/v1/usage" \
  -H "X-API-Key: $APIAUTO_KEY"
```

JavaScript:

```js
const response = await fetch(
  "https://api.apiauto.space/v1/usage",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();
```

Python:

```python
import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/usage",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()
```

PHP:

```php
<?php
$ch = curl_init("https://api.apiauto.space/v1/usage");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
```

## Ответ

HTTP 200:

```json
{
  "plan": "demo",
  "status": "demo",
  "expires_at": "2026-10-22T12:04:00Z",
  "period": "demo",
  "reset_at": "2026-10-22T12:04:00Z",
  "quota_unit": "requests",
  "quota_limit": 100,
  "quota_used": 3,
  "records_limit": 0,
  "records_used": 0,
  "live_us_limit": 0,
  "live_us_used": 0,
  "by_market": [
    {
      "market": "kr",
      "records": 40,
      "requests": 2,
      "live_us_requests": 0
    },
    {
      "market": "cn",
      "records": 20,
      "requests": 1,
      "live_us_requests": 0
    }
  ]
}
```

## Примечания

| Поле | Что значит |
| --- | --- |
| `plan, status` | Тариф и состояние: demo, active или grace (3 дня после окончания). |
| `expires_at, period, reset_at` | Конец срока, период квоты (YYYY-MM или demo) и когда она обновится. |
| `quota_unit` | records у платных тарифов, requests у демо. |
| `quota_limit, quota_used` | Квота периода и сколько потрачено. |
| `records_limit, records_used` | Записи месяца у платных тарифов. |
| `live_us_limit, live_us_used` | Счётчик живого поиска США. |
| `by_market` | Записи, запросы и живые запросы по каждому рынку. |

Значения в примере условные.

---

Страница: https://apiauto.space/docs/endpoints/usage/