# Index size and freshness

`GET https://trawle.com/v1/stats`

## Responses

### 200: Totals.

Schema: SiteStats

- `openJobs` (integer, required)
- `companies` (integer, required): Companies with at least one open job.
- `newToday` (integer, required): Open jobs first seen in the last 24 hours.
- `dataDate` (string<date-time>, required): Example: `2026-10-31T06:12:00.000Z`.
- `historyStart` (string<date-time>, required): First day of Trawle's own history; earlier dates come from employers. Example: `2026-10-31T06:12:00.000Z`.

## Examples

### cURL

```bash
curl "https://trawle.com/v1/stats"
```

### TypeScript

```ts
import createClient from "openapi-fetch";

// npx openapi-typescript https://developers.trawle.com/openapi.json -o trawle.d.ts
import type { paths } from "./trawle";

const trawle = createClient<paths>({ baseUrl: "https://trawle.com" });

const { data, error } = await trawle.GET("/v1/stats");
```

### Python

```python
import requests

response = requests.get(
    "https://trawle.com/v1/stats",
)
response.raise_for_status()
data = response.json()
```

### Response 200

```json
{
  "openJobs": 0,
  "companies": 0,
  "newToday": 0,
  "dataDate": "2026-10-31T06:12:00.000Z",
  "historyStart": "2026-10-31T06:12:00.000Z"
}
```