canonical: https://jentic.com/apis/karma.domains/karma-domains

# Karma.Domains Public API

The Karma.Domains API delivers domain intelligence over auction, expired, backorder, and buy-now inventories alongside per-domain SEO and authority metrics. It checks domain authority, backlinks, anchor text, indexed pages, estimated traffic, and a proprietary Karma Metric, runs WHOIS and DNS lookups, and verifies registration and expiry dates. Saved filters, favourites, report sharing, and webhooks let an agent automate the same research and alerting workflows that the Karma.Domains web app exposes.

## For AI agents

Search domain inventories and pull SEO and authority signals such as domain authority, backlinks, traffic, WHOIS, and the Karma Metric, with saved filters and webhooks for automation.

## Scope

Does not register, buy, or transfer domains, and does not host DNS. Use for domain intelligence, SEO metrics, and inventory research only.

## Capabilities

- Search auction, expired, backorder, and buy-now domain inventories with filters
- Check domain authority, backlinks, anchor text, and indexed page counts for a domain
- Estimate a domain's traffic and spam score before acquiring it
- Run WHOIS and DNS lookups and verify registration and expiry dates
- Score a domain with the proprietary Karma Metric
- Save filters and register webhooks that alert on matching domains

## Use cases

### AI agent domain research via Jentic

An AI agent connected through Jentic evaluates candidate domains without reading Karma.Domains' reference docs. It searches an inventory by intent, Jentic returns the matching operation with its input schema, and the agent pulls domain authority, backlinks, and the Karma Metric to rank options. The developer's own Jentic One instance injects the bearer token at call time.

Example prompt: Call POST `/v1/reports/search` to find expired domains, then GET `/v1/domains/checker/domain_authority` and GET `/v1/domains/checker/backlinks` for each candidate

### Expired and auction domain sourcing

Domain investors mine auction, expired, backorder, and buy-now inventories for undervalued names. The API searches these report bases with filters, looks up reports by domain, and returns the full report, letting an agent surface candidates that match authority and traffic thresholds and save the filter for reuse.

Example prompt: Call POST `/v1/reports/search` with inventory filters, then POST `/v1/user/saved-filters` to persist the query for repeated runs

### SEO due diligence before acquisition

Before buying a domain, teams verify its authority is real and not inflated. The API checks domain authority, backlinks, anchor text, indexed pages, estimated traffic, and spam score, so an agent can flag a domain whose metrics do not hold up and only recommend ones that clear its thresholds.

Example prompt: Call GET `/v1/domains/checker/spam_score` and GET `/v1/domains/checker/anchors` for a domain to assess backlink quality before acquisition

### Expiry and availability monitoring

Agents watch for names dropping or coming up for renewal. The API verifies registration and expiry dates, checks expired-domain reports, and registers webhooks that fire on matching domains, so a monitoring agent is notified rather than polling the inventory on a schedule.

Example prompt: Call GET `/v1/domains/checker/registration_expiry` for a domain, then POST `/v1/webhooks`/ to register an alert for matching results

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/reports/search` | Search inventory report bases |
| GET | `/v1/reports/by-domain` | Look up reports by domain |
| GET | `/v1/domains/checker/domain_authority` | Check domain authority |
| GET | `/v1/domains/checker/backlinks` | Check backlinks for a domain |
| GET | `/v1/domains/checker/karma_metric` | Get the Karma Metric for a domain |
| GET | `/v1/domains/checker/whois` | Run a WHOIS lookup |
| POST | `/v1/user/saved-filters` | Create a reusable saved filter |
| POST | `/v1/webhooks/` | Create a webhook |

## Key resources

- **Reports** — Search inventory report bases, look up reports by domain, and read the full report
- **Domain Checkers** — Domain authority, backlinks, anchors, traffic, spam score, WHOIS, DNS, and expiry lookups
- **Saved Filters** — Create, read, and manage reusable domain search filters
- **Webhooks** — Register and manage webhooks that alert on matching domains

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 59 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 49 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 46 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 72 / 100
- **View full report:** https://jentic.com/apis/karma.domains/karma-domains/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Karma.Domains API by hand means learning its bearer scheme, managing a Pro subscription or age credits, and shaping inventory filters across report bases yourself. Through Jentic you install once, import Karma.Domains from the API Directory, store the key once, and your agent calls the search and checker operations.
- **Permission scoping:** Karma.Domains puts the resource id in the URL path for saved filters and webhooks (`/v1/user/saved-filters/{filter_id}`, `/v1/webhooks/{subscription_id}`), so a rule can keep your agent on the read side: search reports and run domain checks. You choose the operations it may call, so ones that create filters, share reports, or rotate a webhook secret are not included unless you add them.
- **Credential handling:** Your Karma.Domains API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find expired domains' or 'check domain authority', and Jentic returns the matching Karma.Domains operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Moz Links API** — Moz Links returns domain authority and link metrics, where Karma.Domains pairs similar metrics with acquisition inventories.
- **Ahrefs API** — Ahrefs provides deep backlink and keyword data; Karma.Domains focuses on domain inventories plus authority signals.
- **IP2WHOIS API** — IP2WHOIS resolves registration and ownership records that complement Karma.Domains' WHOIS and expiry checks.
- **BuiltWith Domain API** — BuiltWith reports the technology stack of a domain, adding context to Karma.Domains' authority and traffic data.

## FAQ

### What authentication does the Karma.Domains API use?

The Karma.Domains API authenticates with an HTTP bearer token in the Authorization header, formatted as Authorization: Bearer followed by your API key, per its OpenAPI spec. Access requires a Pro subscription or age credits. Through Jentic, your key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's context.

### Can I check a domain's authority and backlinks with the Karma.Domains API?

Yes. The domain checker operations return domain authority, backlink counts, anchor text, indexed pages, estimated traffic, and a spam score for a given domain, and the Karma Metric endpoint returns the proprietary score. An agent can combine these to rank candidate domains before acquisition.

### What are the rate limits for the Karma.Domains API?

The OpenAPI spec does not state numeric rate limits, and some operations draw on a Pro subscription or age credits. Check the Karma.Domains documentation at https://karma.domains for current limits and credit costs.

### How do I search expired domains through Jentic?

Search Jentic by intent such as finding expired domains, and it returns the Karma.Domains report search operation with its input schema. Pass your inventory filters, read the ranked results, and persist the query as a saved filter, with your key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the Karma.Domains API?

Yes. Write a rule that allows only the report search and domain checker read operations, so the agent can research and score domains but cannot create saved filters, share reports, or rotate a webhook secret, and every call it makes is logged by your self-hosted instance.

### Is there a Karma.Domains API MCP server?

You do not need an MCP server to give your agent the Karma.Domains API. Jentic connects it directly from the API Directory: import it, store your bearer token once, and your agent calls the search and checker operations on demand without loading another server's tool definitions into its context.