reports

Search Bases Reports

Search reports across all bases (auctions, expired, backorder, buynow).

Uses the same filters as the app table with report_type=all. Each list item includes report_url (link to the report in the web app). For a simple exact domain lookup (identifiers only), use GET /by-domain?domain=. For the full report body, use GET /report?report_type=&report_id=. Agent accounts: 1 credit per call from spendable balance.

post/v1/reports/search

Request

  • Base URL: https://api.karma.domains
  • URL: https://api.karma.domains/v1/reports/search
  • Auth: HTTP bearer

Query parameters

sort_by'report_type' | 'auction_source' | 'karmascore' | 'karmametric' | 'brandscore' | 'openpagerank' | 'sr_as' | 'sr_bl' | 'sr_rd' | 'sr_traffic' | 'ahrefs_dr' | 'ahrefs_ur' | 'moz_da' | 'moz_ss' | 'moz_bl' | 'moz_rd' | 'majestic_tf' | 'majestic_cf' | 'majestic_ratio' | 'majestic_bl' | 'majestic_rd' | 'ke_etv' | 'ke_total' | 'wa_age' | 'wa_last_snap' | 'sw_last_traffic' | 'auction_bids' | 'auction_price' | 'auction_end_time' | 'added_at'

Table column name to sort by. Allowed values: report_type, auction_source, karmascore, karmametric, brandscore, openpagerank, sr_as, sr_bl, sr_rd, sr_traffic, ahrefs_dr, ahrefs_ur, moz_da, moz_ss, moz_bl, moz_rd, majestic_tf, majestic_cf, majestic_ratio, majestic_bl, majestic_rd, ke_etv, ke_total, wa_age, wa_last_snap, sw_last_traffic, auction_bids, auction_price, auction_end_time, added_at

sort_descboolean
pageinteger
page_sizeinteger

Request body

favoritesboolean nullable

Filter by favorites. True = show only favorite reports, False = exclude favorites. Requires user_id to be provided.

has_annotationsboolean nullable

Filter by report annotations. True = only reports with a note or tags, False = exclude annotated reports. Pro only.

report_tagsstring[] nullable

Filter by annotation tags (AND logic — report must contain all selected tags). Pro only.

tldsstring nullable

List of TLD's separated by comma or space

domainstring nullable

Domain Name. Use comma (,) for AND logic (all domains must match) or pipe (|) for OR logic (any domain matches). Case-insensitive substring search.

categoriesstring[] nullable

List of categories. Each category will be searched with OR logic (any category matches). Use exact flat category names. Case-insensitive substring search.

categories_excludestring[] nullable

Categories to exclude. OR logic — domain is excluded if it has ANY listed category. Use exact flat category names. Case-insensitive substring search.

domain_typestring[] nullable

Filter by domain base type: auctions, backorder, buynow, or expired. OR logic (any selected type matches).

languagesstring nullable

List of languages. Use comma (,) for AND logic (all languages must match) or pipe (|) for OR logic (any language matches). Case-insensitive substring search.

keywordsstring nullable

Keywords to search in web archive content (title, description, h1-h6, etc.). Use comma (,) for AND logic (all keywords must be found) or pipe (|) for OR logic (any keyword found).

openpagerank_mininteger nullable

Openpagerank (OPR) Min (0-10)

openpagerank_maxinteger nullable

Openpagerank (OPR) Max (0-10)

domain_numbersboolean nullable

Domain Name has Numbers (True/False)

domain_hyphensboolean nullable

Domain Name has Hyphens (True/False)

domain_length_mininteger nullable

Domain Name Length Min (1-30)

domain_length_maxinteger nullable

Domain Name Length Max (1-30)

majestic_tf_mininteger nullable

Majestic Trust Flow (TF) Min (0-100)

majestic_tf_maxinteger nullable

Majestic Trust Flow (TF) Max (0-100)

majestic_cf_mininteger nullable

Majestic Citation Flow (CF) Min (0-100)

majestic_cf_maxinteger nullable

Majestic Citation Flow (CF) Max (0-100)

majestic_ratio_minnumber nullable

Majestic Ratio (TF/CF) Min. Two decimals, empty when CF is 0.

majestic_ratio_maxnumber nullable

Majestic Ratio (TF/CF) Max. Two decimals, empty when CF is 0.

majestic_bl_mininteger nullable

Majestic Backlinks (BL) Min

majestic_bl_maxinteger nullable

Majestic Backlinks (BL) Max

majestic_rd_mininteger nullable

Majestic Referring Domains (RD) Min

majestic_rd_maxinteger nullable

Majestic Referring Domains (RD) Max

wa_age_mininteger nullable

Domain age in years (Min) by Wayback Machine

wa_age_maxinteger nullable

Domain age in years (Max) by Wayback Machine

wa_first_snapstring[] nullable

Wayback Machine first snap date range. Array of 2 strings: [start_date, end_date]. Format: 'YYYY-MM-DD' (e.g., ['2020-01-01', '2023-12-31']). Time is automatically set to 00:00:00 for start and 23:59:59 for end.

wa_last_snapstring[] nullable

Wayback Machine last snap date range. Array of 2 strings: [start_date, end_date]. Format: 'YYYY-MM-DD' (e.g., ['2020-01-01', '2023-12-31']). Time is automatically set to 00:00:00 for start and 23:59:59 for end.

karmascore_mininteger nullable

KarmaScore Min (0-100)

karmascore_maxinteger nullable

KarmaScore Max (0-100)

wa_hieroglyphsboolean nullable

Content has Hieroglyphs (Asian Content) in Wayback Machine (True/False)

wa_redirectsboolean nullable

Content has redirects in Wayback Machine. True = has redirects (HTTP codes 301, 302, 307, 308), False = no redirects.

wa_error403boolean nullable

Content has HTTP error code 403 (Forbidden) in Wayback Machine. True = has 403 errors, False = no 403 errors.

wa_changes_mininteger nullable

Minimum number of content changes in Wayback Machine history

wa_changes_maxinteger nullable

Maximum number of content changes in Wayback Machine history

wa_parkings_mininteger nullable

Minimum number of parking pages in Wayback Machine history

wa_parkings_maxinteger nullable

Maximum number of parking pages in Wayback Machine history

wa_redirects_mininteger nullable

Minimum number of redirects in Wayback Machine history

wa_redirects_maxinteger nullable

Maximum number of redirects in Wayback Machine history

wa_server_codeinteger nullable

HTTP server response code in Wayback Machine (e.g., 200, 301, 302, 403, 404). Used together with wa_server_code_ratio_min/max. Filters by server_code field.

wa_server_code_ratio_minnumber nullable

Server Code Ratio in Wayback Machine Min (0-100)

wa_server_code_ratio_maxnumber nullable

Server Code Ratio in Wayback Machine Max (0-100)

sw_visits_mininteger nullable

Similarweb Visits Min

sw_visits_maxinteger nullable

Similarweb Visits Max

sw_ts_social_minnumber nullable

Similarweb Traffic Sources Social Ratio Min (0-100)

sw_ts_social_maxnumber nullable

Similarweb Traffic Sources Social Ratio Max (0-100)

sw_ts_paid_referrals_minnumber nullable

Similarweb Traffic Sources Paid Referrals Ratio Min (0-100)

sw_ts_paid_referrals_maxnumber nullable

Similarweb Traffic Sources Paid Referrals Ratio Max (0-100)

sw_ts_mail_minnumber nullable

Similarweb Traffic Sources Mail Ratio Min (0-100)

sw_ts_mail_maxnumber nullable

Similarweb Traffic Sources Mail Ratio Max (0-100)

sw_ts_referrals_minnumber nullable

Similarweb Traffic Sources Referrals Ratio Min (0-100)

sw_ts_referrals_maxnumber nullable

Similarweb Traffic Sources Referrals Ratio Max (0-100)

sw_ts_search_minnumber nullable

Similarweb Traffic Sources Search Ratio Min (0-100)

sw_ts_search_maxnumber nullable

Similarweb Traffic Sources Search Ratio Max (0-100)

sw_ts_direct_minnumber nullable

Similarweb Traffic Sources Direct Ratio Min (0-100)

sw_ts_direct_maxnumber nullable

Similarweb Traffic Sources Direct Ratio Max (0-100)

sw_country_share_minnumber nullable

Similarweb Country Share Ratio Min (0-100)

sw_country_share_maxnumber nullable

Similarweb Country Share Ratio Max (0-100)

sw_last_traffic_datestring[] nullable

Similarweb last traffic date range. Array of 2 strings: [start_date, end_date]. Format: 'YYYY-MM' (e.g., ['2023-01', '2023-12']). Filters by Year and Month fields.

moz_da_mininteger nullable

Moz Domain Authority (DA) Min

moz_da_maxinteger nullable

Moz Domain Authority (DA) Max

moz_ss_mininteger nullable

Moz Spam Score (SS) Min (0-100)

moz_ss_maxinteger nullable

Moz Spam Score (SS) Max (0-100)

moz_bl_mininteger nullable

Moz Backlinks (External Pages) Min

moz_bl_maxinteger nullable

Moz Backlinks (External Pages) Max

moz_rd_mininteger nullable

Moz Referring Domains (RD) Min

moz_rd_maxinteger nullable

Moz Referring Domains (RD) Max

moz_bl_urlstring nullable

Moz backlink URL source(s). Use comma (,) for AND logic (all URLs must be found) or pipe (|) for OR logic (any URL found). Case-insensitive phrase matching.

moz_bl_anchorstring nullable

Moz backlink anchor text(s). Use comma (,) for AND logic (all anchors must be found) or pipe (|) for OR logic (any anchor found). Case-insensitive phrase matching.

ahrefs_dr_minnumber nullable

Ahrefs Domain Rating (DR) Min (0-100)

ahrefs_dr_maxnumber nullable

Ahrefs Domain Rating (DR) Max (0-100)

ahrefs_ur_minnumber nullable

Ahrefs URL Rating (UR) Min (0-100)

ahrefs_ur_maxnumber nullable

Ahrefs URL Rating (UR) Max (0-100)

ahrefs_ar_mininteger nullable

Ahrefs Rank (AR) Min (lower rank = stronger domain)

ahrefs_ar_maxinteger nullable

Ahrefs Rank (AR) Max

sr_as_minnumber nullable

Semrush Authority Score (AS) Min (0-100)

sr_as_maxnumber nullable

Semrush Authority Score (AS) Max (0-100)

sr_bl_mininteger nullable

Semrush Backlinks Min

sr_bl_maxinteger nullable

Semrush Backlinks Max

sr_rd_mininteger nullable

Semrush Referring Domains Min

sr_rd_maxinteger nullable

Semrush Referring Domains Max

sr_ip_mininteger nullable

Semrush Referring IPs Min

sr_ip_maxinteger nullable

Semrush Referring IPs Max

sr_edu_mininteger nullable

Semrush EDU Backlinks Min

sr_edu_maxinteger nullable

Semrush EDU Backlinks Max

sr_gov_mininteger nullable

Semrush GOV Backlinks Min

sr_gov_maxinteger nullable

Semrush GOV Backlinks Max

sr_visits_mininteger nullable

Semrush Visits Min

sr_visits_maxinteger nullable

Semrush Visits Max

sr_users_mininteger nullable

Semrush Unique Visitors Min

sr_users_maxinteger nullable

Semrush Unique Visitors Max

sr_desktop_share_minnumber nullable

Semrush Desktop Share Min (0-100%)

sr_desktop_share_maxnumber nullable

Semrush Desktop Share Max (0-100%)

sr_mobile_share_minnumber nullable

Semrush Mobile Share Min (0-100%)

sr_mobile_share_maxnumber nullable

Semrush Mobile Share Max (0-100%)

sr_direct_mininteger nullable

Semrush Traffic Direct Min

sr_direct_maxinteger nullable

Semrush Traffic Direct Max

sr_search_organic_mininteger nullable

Semrush Traffic Search Organic Min

sr_search_organic_maxinteger nullable

Semrush Traffic Search Organic Max

sr_search_paid_mininteger nullable

Semrush Traffic Search Paid Min

sr_search_paid_maxinteger nullable

Semrush Traffic Search Paid Max

sr_referral_mininteger nullable

Semrush Traffic Referral Min

sr_referral_maxinteger nullable

Semrush Traffic Referral Max

sr_social_mininteger nullable

Semrush Traffic Social Min

sr_social_maxinteger nullable

Semrush Traffic Social Max

sr_mail_mininteger nullable

Semrush Traffic Mail Min

sr_mail_maxinteger nullable

Semrush Traffic Mail Max

ke_etv_mininteger nullable

KeywordsEverywhere Estimated Traffic Value (ETV) Min

ke_etv_maxinteger nullable

KeywordsEverywhere Estimated Traffic Value (ETV) Max

ke_total_mininteger nullable

KeywordsEverywhere Total Keywords Min

ke_total_maxinteger nullable

KeywordsEverywhere Total Keywords Max

ke_keywordstring nullable

KeywordsEverywhere keyword(s). Use comma (,) for AND logic (all keywords must be found) or pipe (|) for OR logic (any keyword found). Case-insensitive phrase matching.

google_title_indexstring nullable

Search in the Google snippet title when requesting site:domain.tld (domain's pages in Google index). Use comma (,) for AND or pipe (|) for OR. Case-insensitive.

google_title_mentionsstring nullable

Search in the Google snippet title when requesting "domain.tld" (mentions). Use comma (,) for AND or pipe (|) for OR. Case-insensitive.

google_description_indexstring nullable

Search in the Google snippet description when requesting site:domain.tld (domain's pages in Google index). Use comma (,) for AND or pipe (|) for OR. Case-insensitive.

google_description_mentionsstring nullable

Search in the Google snippet description when requesting "domain.tld" (mentions). Use comma (,) for AND or pipe (|) for OR. Case-insensitive.

google_has_indexboolean nullable

At least one Google result for site:domain.tld (domain's pages in Google index). True/False. None = any.

google_has_mentionsboolean nullable

At least one Google result for "domain.tld" (sites that mention the domain). True/False. None = any.

brandscore_mininteger nullable

Brandscore Min (0-100). Brandscore is the domain brandiness indicator: higher value = more brand-like, brandable (brand-worthy, suitable for a brand).

brandscore_maxinteger nullable

Brandscore Max (0-100). Brandscore is the domain brandiness indicator: higher value = more brand-like, brandable (brand-worthy, suitable for a brand).

karmametric_mininteger nullable

Karma Metric Min (0-100)

karmametric_maxinteger nullable

Karma Metric Max (0-100)

auction_sourcestring[] nullable

Auction source(s). Each item can be a source name or 'source|sale_type' format (e.g., ['godaddy', 'namejet|buynow']). Case-insensitive matching. Items are combined with OR logic.

report_added_timestring[] nullable

Report added date range. Array of 2 strings: [start_date, end_date]. Format: 'YYYY-MM-DD' (e.g., ['2020-01-01', '2023-12-31']). Time is automatically set to 00:00:00 for start and 23:59:59 for end. Filters by added_at field.

auction_price_minnumber nullable

Auction Price Min (USD/EUR)

auction_price_maxnumber nullable

Auction Price Max (USD/EUR)

auction_bids_mininteger nullable

Auction Bids Min (Number of bids)

auction_bids_maxinteger nullable

Auction Bids Max (Number of bids)

website_idsstring[] nullable

List of website service IDs (e.g., Google Analytics ID, Yandex Metrika ID). OR logic - finds domains with ANY of the specified IDs. Used to find domains owned by the same owner.

name_startsstring nullable

Second-level name starts with this sequence. Several alternatives separated by a space or | always use OR. A hyphen stays inside one value. Case-insensitive. Example: car auto.

name_endsstring nullable

Second-level name ends with this sequence. Several alternatives separated by a space or | always use OR. A hyphen stays inside one value. Case-insensitive. Example: shop store.

ln_patternstring[] nullable

Letter/digit patterns of the second-level name. OR logic. L=letter, N=digit, H=hyphen, X=other. Example: LLLL, LLNN.

cv_patternstring[] nullable

Vowel/consonant patterns of the second-level name. OR logic. V=aeiouy, C=other Latin letter, N=digit, H=hyphen, X=other. Example: CVCV.

digit_count_mininteger nullable

Minimum number of digits in the second-level name.

digit_count_maxinteger nullable

Maximum number of digits in the second-level name.

hyphen_count_mininteger nullable

Minimum number of hyphens in the second-level name.

hyphen_count_maxinteger nullable

Maximum number of hyphens in the second-level name.

name_word_count_mininteger nullable

Minimum number of classified words in the name.

name_word_count_maxinteger nullable

Maximum number of classified words in the name.

name_typesstring[] nullable

Name types from settings/name_analysis.json. OR logic. A domain matches if any selected type is present.

name_languagesstring[] nullable

Detected name language codes. OR logic.

name_tokenstring nullable

Exact classified token anywhere in the name. Case-insensitive.

name_industriesstring[] nullable

Industry ids from settings/name_analysis.json. OR logic.

name_first_tokenstring nullable

Exact first classified token. Several alternatives separated by | use OR. Case-insensitive. Example: blog|shop.

name_last_tokenstring nullable

Exact last classified token. Several alternatives separated by | use OR. Case-insensitive. Example: blog|shop.

name_confidence_minnumber nullable

Minimum overall name-classification confidence, from 0 to 1.

name_status'completed' | 'failed' nullable

Name analysis state. Absent analysis is not completed and not failed.

Response

Successful Response

total_countinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.