Karma

Karma.Domains Public API

Public API for Karma.Domains: programmatic access to domain intelligence — reports across auctions, expired, backorder, and buy-now inventories, SEO and…

Developer tools#programming

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

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 (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 (HTTP 422 when exceeded — narrow filters; deep offsets are not supported).

Live-tool quota: 200 non-cache live-tool calls per day per account (UTC reset). Shared across all domain checker endpoints. Cache hits do not count. Responses include the same X-Quota-* headers; HTTP 429 on exceed.

User tasks: batch checker/recheck via /v1/tasks (scopes tasks:read / tasks:write). Per task: up to usertasks.max_items_per_task accepted items. Daily (UTC): usertasks.daily_items_limit accepted items per account across web, API, and MCP (restarts count; idempotent create replays do not).

Webhooks: POST /v1/webhooks registers an HTTPS endpoint (Zapier, Make, n8n, IFTTT, or any HTTPS client). Limits: 30 subscriptions and 5,000 deliveries per account per UTC day.

Endpoints 51

reports

  • POSTSearch Bases Reports/v1/reports/searchSearch reports across all bases (auctions, expired, backorder, buynow). Uses the same filters as the app table with report_type=all. Each list item includes…
  • GETList Favorite Reports/v1/reports/favoritesList the current user's favorite reports across all bases. Same response shape as POST /search with favorites: true. For favorites combined with other…
  • POSTAdd Favorite Report/v1/reports/favoritesAdd a report to the current user's favorites. Requires Pro API key. Agent accounts: 1 credit per call from spendable balance.
  • DELETERemove Favorite Report/v1/reports/favorites?report_type=expired&report_id=507f1f77bcf86cd799439011Remove a report from the current user's favorites. Requires Pro API key. Agent accounts: 1 credit per call from spendable balance.
  • GETList Report Annotation Tags/v1/reports/annotations/tagsDistinct annotation tags for the current user (sorted).
  • GETGet Report Annotation/v1/reports/annotations?report_type=expired&report_id=507f1f77bcf86cd799439011Get note and tags for a single report.
  • PUTSet Report Annotation/v1/reports/annotationsSet or clear report annotation (note + tags). Pro plan required. Agent: 1 credit.
  • DELETEDelete Report Annotation/v1/reports/annotations?report_type=expired&report_id=507f1f77bcf86cd799439011Delete report annotation. Pro plan required. Agent accounts: 1 credit per call.
  • POSTCreate Report Share Link/v1/reports/shareCreate or reuse a guest share link for a bases report. Pro plan required. Agent: 1 credit.
  • POSTEnrich Report Seo Public/v1/reports/:report_type/:report_id/enrich-seoStart paid SEO enrich job (Pro/Unlimited). Poll GET /enrich-jobs/{job_id}.
  • GETGet Enrich Seo Job Public/v1/reports/enrich-jobs/:job_idPoll an SEO enrich job by ID.
  • GETLookup Reports By Domain/v1/reports/by-domain?domain=example.comFind report identifiers by exact domain name in all bases collections. Returns every match (at most one per collection). Empty matches if the domain is not…
  • GETCheck Domain Report/v1/reports/check/expired?report_id=507f1f77bcf86cd799439011Check whether the report domain is available (drop). NOTE: report_id is the id of the expired report, not the domain. is_expired: true means the domain…
  • GETGet Full Report/v1/reports/report?report_type=expired&report_id=507f1f77bcf86cd799439011Get full report by collection type and MongoDB document id. Agent accounts: 1 credit per call from spendable balance.

user

  • GETList User Saved Filters/v1/user/saved-filtersList the user's saved search filters.
  • POSTCreate User Saved Filter/v1/user/saved-filtersCreate a saved search filter. Agent accounts: 1 credit per call.
  • GETGet User Saved Filter/v1/user/saved-filters/:filter_idGet one saved search filter by id.
  • DELETEDelete User Saved Filter/v1/user/saved-filters/:filter_idDelete one saved search filter. Agent accounts: 1 credit per call.
  • PATCHPatch User Saved Filter/v1/user/saved-filters/:filter_idUpdate one saved search filter. Agent accounts: 1 credit per call.
  • GETGet Current User Profile/v1/userReturn the authenticated user's profile (email, joined date, credits, plans). Omits payment stats, UTM, API key, and other internal fields. Requires Pro API…

domains

  • GETCheck Domain Expiry/v1/domains/checker/expiry?domain=example.comCheck if a domain name appears free for registration (live WHOIS/DNS). available: true — domain likely free; false — registered or reserved. Does not update…
  • GETGet Domain Karma Metric/v1/domains/checker/karma_metric?domain=example.comCompute Karma Metric from Web Archive history for a domain (live check). Returns score 0 with null period when TLD is ignored or Archive has no data. Does not…
  • GETDomain Authority Checker/v1/domains/checker/domain_authority?domain=example.comLive Domain Authority metrics (Ahrefs, Moz, Semrush, Karma Metric). Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETDomain Age Checker/v1/domains/checker/domain_age?domain=example.comLive Wayback archive age: first/last snapshot timestamps and sparkline. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETDomain Expiry Checker/v1/domains/checker/registration_expiry?domain=example.comLive WHOIS/RDAP registration expiry (created/expires, days left, status). Different from /checker/expiry which only returns available true/false. Costs 1…
  • GETBacklink Checker/v1/domains/checker/backlinks?domain=example.comLive Moz backlink summary and sample backlinks. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETAnchor Text Checker/v1/domains/checker/anchors?domain=example.comLive Moz anchor-text aggregation and word frequencies. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETWebsite Page Counter/v1/domains/checker/pages?domain=example.comCount unique page URLs from the site sitemap for a domain. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETWebsite Traffic Checker/v1/domains/checker/traffic?domain=example.comLive SimilarWeb and Semrush traffic estimates for a domain. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETDns Lookup/v1/domains/checker/dns?domain=example.comLive DNS lookup across public resolvers (A, AAAA, MX, NS, TXT, …). Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETWhois Lookup/v1/domains/checker/whois?domain=example.comLive structured WHOIS/RDAP (registrar, contacts, nameservers, dates). Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETSpam Score Checker/v1/domains/checker/spam_score?domain=example.comLive Moz Spam Score plus DA, backlinks, and referring domains. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETRedirect Checker/v1/domains/checker/redirect?url=https://example.com/Follow HTTP redirect chains (3xx Location and meta refresh) for one URL. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.
  • GETIp Lookup/v1/domains/checker/ip?target=example.comResolve a domain or enrich a public IP (A/AAAA, geo, ASN, PTR via DB-IP Lite). Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache…
  • GETHosting Checker/v1/domains/checker/hosting?domain=example.comHosting/CDN hints from DNS, geo on resolved IPs, and Server header. Domain or public IP. Costs 1 credit from spendable balance for Pro (8 for agent accounts);…
  • GETBuilt With Checker/v1/domains/checker/built_with?domain=example.comTechnology stack from homepage fingerprints and public response headers. Costs 1 credit from spendable balance for Pro (8 for agent accounts); cache hits free.

tasks

  • GETList Tasks/v1/tasks/List the authenticated user's batch checker / recheck tasks.
  • POSTCreate Task/v1/tasks/Create a usercheck v2 task (validate, debit credits, enqueue pipeline steps). Caps: usertasks.max_items_per_task accepted items per task (checker or recheck).…
  • GETGet Task/v1/tasks/:task_idTask detail for the owner (progress, counts, billing summary, step summary).
  • DELETEDelete Task/v1/tasks/:task_idDelete a finished task asynchronously (HTTP 202, deleting). Credits are not refunded.
  • POSTRestart Task/v1/tasks/:task_id/restartRestart failed items on a done_with_errors task (charges again). Restarted items count toward usertasks.daily_items_limit (HTTP 429 when exceeded).
  • POSTList Task Reports/v1/tasks/:task_id/reportsList task result rows (only report ids attached to the task). Same filters as the web task table. Consumes shared list-row quota (50k/day UTC). Pagination…
  • GETGet Task Report/v1/tasks/:task_id/reports/:report_idFull report body for one task result row (owner-only). Agent accounts: same full-report credit policy as GET /v1/reports/report (1 agent credit per call when…

webhooks

  • GETList Webhooks/v1/webhooks/List webhook subscriptions for the current account.
  • POSTCreate Webhook/v1/webhooks/Create a webhook subscription. The signing secret is returned once. kind=filter sends domain.matched_filter when a report starts matching the same filters as…
  • GETGet Webhook/v1/webhooks/:subscription_idGet one webhook subscription. The signing secret is not included.
  • DELETEDelete Webhook/v1/webhooks/:subscription_idDelete a webhook subscription and stop deliveries.
  • PATCHPatch Webhook/v1/webhooks/:subscription_idUpdate a webhook subscription. status accepts active or paused.
  • POSTRotate Webhook Secret/v1/webhooks/:subscription_id/secretRotate the signing secret. The new secret is returned once.
  • POSTPing Webhook/v1/webhooks/:subscription_id/pingSend a webhook.ping event to the subscription URL and return the attempt.
  • GETWebhook Deliveries/v1/webhooks/:subscription_id/deliveriesRecent delivery attempts for a subscription. Secrets are not included.

API details

Base URL
https://api.karma.domains
https://karma.domains
Authentication
A bearer token in the Authorization header
Operations
51 operations on 39 pathsGET 32POST 11DELETE 5PATCH 2PUT 1
Main resources
domains 16reports 14webhooks 8tasks 7user 6
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Karma.Domains Public API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Karma.Domains Public API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Search Bases Reports” (POST /v1/reports/search), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Karma.Domains Public API?

Public API for Karma.Domains: programmatic access to domain intelligence — reports across auctions, expired, backorder, and buy-now inventories, SEO and… It is listed under Developer tools and has 51 endpoints.

Who publishes the Karma.Domains Public API?

It is listed from Karma's public API description (an OpenAPI document), not published by Karma on Swastik Codes. Anyone who controls karma.domains can claim the profile by adding a DNS TXT record.

What is the base URL of the Karma.Domains Public API?

Its description lists 2 base URLs: https://api.karma.domains, https://karma.domains. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Karma.Domains Public API?

With A bearer token in the Authorization header.

How many endpoints does the Karma.Domains Public API have?

51 operations on 39 paths (32 GET, 11 POST, 5 DELETE, 2 PATCH, 1 PUT). The largest groups are domains, reports, webhooks, tasks.

Is forking the Karma.Domains Public API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.