06 Endpoints

Quota usage by market

GET /v1/usage

The plan, its term and how much quota is spent — in total and per market. Free: handy before a large import.

Example requests

Parameters

This request takes no parameters.

Request `GET`

GEThttps://api.apiauto.space/v1/usage

cURL

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

JavaScript

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

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
$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);

Get a test key

The site sends no requests: copy the code and run it with your key.

Response

HTTP 200

{
  "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
    }
  ]
}

Sample data: the cars are real, from the catalog when the site was built; photos are cut to two.

Notes

Field	Meaning
`plan, status`	The plan and its state: demo, active or grace (3 days after the end).
`expires_at, period, reset_at`	The term's end, the quota period (YYYY-MM or demo) and when it renews.
`quota_unit`	records on paid plans, requests on the demo.
`quota_limit, quota_used`	The period quota and how much is spent.
`records_limit, records_used`	The month's records on paid plans.
`live_us_limit, live_us_used`	The live US search counter.
`by_market`	Records, requests and live requests per market.

The sample's values are made up.