---
title: "Look up up to 25 domains in one call"
method: GET
path: "/api/v1/domain/{service}/batch"
tags: ["Domain"]
---

# Look up up to 25 domains in one call

`GET /api/v1/domain/{service}/batch`

## Request

- Base URL: `https://xranks.com`
- URL: `https://xranks.com/api/v1/domain/{service}/batch`
- Auth: API key in header `Authorization`

Same data as the single-domain endpoint for each domain. Each domain that returns data uses one lookup; unknown or invalid domains come back as error items and are free.

## Query parameters

- `domains` string[], required

## Response `200`

One result per domain, in request order (duplicates removed).

- BatchResponse
  - `service` string
  - `count` integer
  - `lookups_used` integer: Domains that returned data (= lookups charged).
  - `results` object[]

## Other responses

- `400`: Invalid domain or malformed request.
- `401`: Missing, invalid or inactive API key.
- `404`: Unknown domain, no data, or unknown service.
- `429`: Quota used up for the rolling 30 days (or the batch needs more lookups than are left).

---

[API](https://skmtc.dev/xranks/apis/xranks-domain-data-api.md) · [All operations](https://skmtc.dev/xranks/apis/xranks-domain-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xranks/apis/xranks-domain-data-api/revisions/c1c3388c4b34?raw)