# Karma.Domains Report Search API

> Karma.Domains Report Search API is a paid API for AI agents from api.karma.domains, paid per call via x402, $1.5/call, status unknown (last checked 2026-10-12).

Search and filter domain reports by SEO metrics, keywords, TLD, language, category, and more to find high-value expired or available domains.

## Facts

- Endpoint: GET https://api.karma.domains/v1/reports/search?utm_source=zero.xyz
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/karma-domains-report-search-api-9422d2af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gvwaCkJXWLOztclIjW68s

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability karma-domains-report-search-api-9422d2af
```

Example prompt: Search Karma.Domains for expired domains with a .com or .io TLD, Moz DA of at least 30, Majestic Trust Flow above 20, and keywords like 'coffee' or 'cafe' in their archived content — show me up to 20 results.

## When to prefer this

Use this endpoint when you need to discover, filter, or score domains based on multi-dimensional SEO signals (Moz, Ahrefs, Majestic, KeywordsEverywhere), web archive content keywords, TLD, language, or category. Ideal for domain investors, SEO professionals, and agents building domain acquisition pipelines. Prefer this over generic WHOIS or availability APIs when rich SEO metric filtering and historical web archive data are required.

## Known failure modes

- HTTP 402 with PAYMENT-REQUIRED header when unauthenticated or credits exhausted — retry with PAYMENT-SIGNATURE header
- HTTP 429 with Retry-After header when 60 requests/minute rate limit is exceeded
- HTTP 503 when rate-limit storage backend is unavailable
- HTTP 400 when invalid filter combinations or out-of-range pagination parameters are supplied (page × page_size > 5000)
- Daily row quota of 50,000 list rows exhausted — X-Quota-Remaining reaches 0 until UTC reset
- Empty report_list with total_count 0 when no domains match the specified filters

## How this service works

Public API for Karma.Domains: programmatic access to domain intelligence — reports across auctions, expired, backorder, and buy-now inventories, SEO and authority metrics, Wayback history, availability checks, and Karma Metric. Use it to search, filter, and automate the same data workflows as the Karma.Domains web app.

**Authentication:** `Authorization: Bearer <api_key>` (Pro subscription or agent credits).
**Agent credits (x402):** HTTP 402 + `PAYMENT-REQUIRED` when unauthenticated; retry same URL with `PAYMENT-SIGNATURE` and optional `X-Karma-Plan-Id`.

**Rate limits:** 60 requests per minute per API key (all endpoints share one counter). Response headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`. On exceed: HTTP 429 with `Retry-After`. If rate-limit storage is unavailable: HTTP 503.

**Row quota:** 50,000 list rows per day per account (UTC reset). List responses include `X-Quota-Limit`, `X-Quota-Remaining`, `X-Quota-Reset`. Pagination: `page_size` 1–100 (Public API); `page × page_size ≤ 5000`.

## Output

Returns a paginated list of domain reports matching the search criteria, each containing the domain name, TLD, SEO metrics (Moz DA/PA, Ahrefs DR/UR, Majestic TF/CF/BL/RD), web archive data (age, languages, server code), categories, AI summary, auction listings, blacklist status, and brand score, along with a total count of matching results and quota/rate-limit headers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "report_list": [],
  "total_count": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/karma-domains-report-search-api-9422d2af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.karma.domains](https://www.zero.xyz/host/api.karma.domains/llms.txt)