{"uid":"cap_fWxOLTzqmVT4tc_BzXaIc","slug":"karma-domains-favorites-reports-list-27c39720","name":"Karma.Domains Favorites Reports List","description":"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.\n\n**Authentication:** `Authorization: Bearer <api_key>` (Pro subscription or agent credits).\n**Agent credits (x402):** HTTP 402 + `PAYMENT-REQUIRED` when unauthenticated; retry same URL with `PAYMENT-SIGNATURE` and optional `X-Karma-Plan-Id`.\n\n**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.\n\n**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`.","url":"https://api.karma.domains/v1/reports/favorites","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"page":{"type":"integer","minimum":1},"sort_by":{"type":"string"},"page_size":{"type":"integer","maximum":100,"minimum":1},"sort_desc":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"status":"ok","message":"Report added to favorites"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nE24GKYUtehWTM4EwjwYE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of domain intelligence reports saved as favorites in the user's Karma.Domains account","exampleAgentPrompt":"Show me my saved favorite domain reports on Karma.Domains — get the first 25, sorted by most recently added.","exampleUseCases":[{"title":"Review saved domain watchlist","prompt":"Pull up all the domains I've bookmarked on Karma.Domains and show me their SEO metrics and Karma scores so I can decide which ones are worth pursuing."},{"title":"Resume domain research session","prompt":"I was researching expired domains yesterday and saved a bunch of favorites — can you grab those saved reports and show me the ones from auction and expired inventory?"},{"title":"Paginate through starred domains","prompt":"I have a lot of favorited domain reports on Karma.Domains. Walk me through them 50 at a time, starting from the most recently added, so I can review each batch."}],"resultDescription":"Returns a paginated list of the authenticated user's favorited domain intelligence reports, including domain names, associated metrics (SEO, authority, Karma Metric), and inventory type (auction, expired, backorder, buy-now), along with quota and rate-limit headers indicating remaining daily row allowance.","failureModes":["HTTP 401 if Bearer token is missing or invalid","HTTP 402 if unauthenticated and agent credits not supplied via PAYMENT-SIGNATURE header","HTTP 429 if 60 requests/minute rate limit exceeded — Retry-After header indicates wait time","HTTP 503 if rate-limit storage backend is unavailable","HTTP 400 if page or page_size parameters are out of allowed range (page < 1, page_size < 1 or > 100)","Empty results list if account has no favorited reports","Daily row quota exhaustion returning 0 remaining rows in X-Quota-Remaining"],"whenToPreferThis":"Use this endpoint when you need to retrieve a user's personally curated list of saved/bookmarked domain reports from Karma.Domains — ideal for building watchlists, reviewing previously starred domains, or resuming domain research sessions. Prefer over search endpoints when the user wants to revisit already-identified domains rather than discover new ones.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:19.188Z","isFirstParty":false}