---
title: "Name server operators and market share"
method: GET
path: "/v1/stats/nameservers"
---

# Name server operators and market share

`GET /v1/stats/nameservers`

## Request

- Base URL: `https://api.aleva.se`
- URL: `https://api.aleva.se/v1/stats/nameservers`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `tld` string
- `tld.in` string
- `operator` string
- `operator.prefix` string
- `domains.gte` integer
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `_meta` Meta, required
    - `attribution` string
    - `build_run_id` integer
    - `built_at` string, date-time
    - `endpoint` string
    - `fetched_at` string, date-time
    - `licenses` string[]
    - `sources` object[]
    - `usage_mode` string
    - `version` integer
  - `data` object[], required
    - `domains` integer: Domains with at least one name server at this operator
    - `fetched_at` string, date-time
    - `operator` string: Registered domain of the name server hosts, e.g. loopia.se
    - `serial` integer
    - `share` number: domains / all domains in the zone
    - `tld` string
  - `next_cursor` string: Present when there are more rows

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit reached

---

[API](https://skmtc.dev/aleva/apis/aleva-api.md) · [All operations](https://skmtc.dev/aleva/apis/aleva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aleva/apis/aleva-api/revisions/2edd15ebc4c9?raw)