---
title: "The account's clusters, newest first"
method: GET
path: "/v1/clusters"
tags: ["clusters"]
---

# The account's clusters, newest first

`GET /v1/clusters`

## Request

- Base URL: `https://api.publicwww.com`
- URL: `https://api.publicwww.com/v1/clusters`
- Auth: HTTP bearer

Spends nothing. An account keeps at most 100 clusters.

## Query parameters

- `format` 'json' | 'xml'

## Response `200`

The clusters.

- ClusterList
  - `count` integer, required
  - `max` integer, required: Most clusters an account keeps.
  - `clusters` Cluster[], required
    - `id` integer, required
    - `name` string, required
    - `size` integer, required: Number of domains.
    - `created` string, date-time, required
    - `submitted` integer: From a list: how many names were sent.
    - `max_size` integer: The plan's cap on domains per cluster.
    - `query` string
    - `total` integer: From a search: results the search found.
    - `index_complete` boolean
    - `query_note` string
    - `operation` 'and' | 'or' | 'diff'
    - `from` integer[]

## Other responses

- `400`: The request cannot be served as asked: missing_query, unknown_format, unknown_column, format_not_available, per_page_too_large, page_too_deep, invalid_json.
- `401`: missing_key - no Authorization: Bearer header; invalid_key - the token does not name an account.
- `403`: No paid plan (plan_required).
- `429`: Too many requests, or the daily search or extraction allowance is used up.

---

[API](https://skmtc.dev/publicwww/apis/publicwww-search-api.md) · [All operations](https://skmtc.dev/publicwww/apis/publicwww-search-api/llms.txt) · [OpenAPI document](https://skmtc.dev/publicwww/apis/publicwww-search-api/revisions/79d49d819de3?raw)