ឯកសារ API សម្រាប់ Expired Domains

REST API តែមួយដែលឆ្លើយតបជា JSON សម្រាប់ domain intelligence: SEO metrics (TF, CF, DA, DR, Age, Backlinks, Traffic ជាដើម), ប្រវត្តិ Wayback Machine, ដូមេនថ្មី 400,000+ ក្នុងមួយថ្ងៃ, data sources ដូមេន 30+, និង filters 90+ សម្រាប់ការស្វែងរកត្រឹមត្រូវ។ រួមមាន live auctions, expired domains, full reports, favorites, availability checks, Karma Metric និង profile data។ Pro Bearer key, 60 requests ក្នុងមួយនាទី។

សាកល្បងឥតគិតថ្លៃ!
ប្រើប្រាក់កម្ចីប្រាក់រង្វាន់!
បើកបញ្ជីដែន
+5

Public API របស់ Karma.Domains ផ្តល់ programmatic access ទៅកាន់ domain reports: auctions, expired, backorder និង buy-now។ Responses ទាំងអស់ជា JSON លើ HTTPS។ Base URL: https://api.karma.domains, route prefix: /v1។

Karma.Domains គឺជា domain intelligence platform សម្រាប់ investors, SEO teams និង automation pipelines:

  • ដូមេនថ្មី 400,000+ រៀងរាល់ថ្ងៃ ក្នុង discovery និង monitoring flows (សរុប 7,000,000+ domains)
  • domain data sources 30+ សរុប រួមទាំង auction/expired/backorder/buy-now sources 27+ (GoDaddy, NameJet, DropCatch, Dynadot, GNAME, Namecheap ជាដើម)
  • filters 90+ សម្រាប់ precise search តាម domain quality, SEO, content history និង auction signals (TF, CF, DA, DR, Age, Backlinks, Traffic, Keywords, Anchor Text ជាដើម)
  • គាំទ្រ TLD និង ccTLD (ឧទាហរណ៍ .com, .net, .org, .biz, .info, .at, .be, .ca, .cc, .cl, .co, .co.nz)
  • SEO និង authority data ពី vendors ធំៗ: Ahrefs, Majestic, Moz, SimilarWeb
  • Historical content និង change signals តាម Wayback Machine

Request/response schemas (filter fields, report structure, sort enums) — នៅក្នុង interactive docs: Swagger UI ឬ ReDoc។
ទំព័រនេះជាភាពសង្ខេបសម្រាប់ integration: authentication, limits, endpoint list, typical workflows និង examples។

Introduction

Public API សម្រាប់ scripts, internal dashboards, CRM systems និង automation ទាំងឡាយដែលត្រូវការទិន្នន័យដូចក្នុង Karma.Domains web app។

  • Format: JSON
  • API version: 1.0.0
  • Databases: auctions, expired, backorder, buynow; ស្វែងរកគ្រប់ database ម្តងតែមួយ — POST /v1/reports/search (ដូចតារាង “all databases” ក្នុង UI)
  • Field documentation: មានតែ OpenAPI
  • ប្រើបានតែសម្រាប់ Pro plan និងខ្ពស់ជាងនេះ

Authentication

Request ទាំងអស់ត្រូវមាន header:

Authorization: Bearer YOUR_API_KEY

របៀបទទួល API key

  1. ត្រូវមាន Pro plan (បើគ្មាន Pro នឹងមិនអាចប្រើ API បាន)។
  2. Profile → Settings — បង្កើត ឬ reset key នៅផ្នែក API key។

Key ដូចគ្នាត្រូវបានប្រើសម្រាប់ MCP server (AI assistants)។ Request limit ត្រូវបាន ចែករំលែក រវាង REST និង MCP។

Typical responses ពេល key ខុស

Code Reason
401 Missing header, invalid key, ឬ typo ក្នុង Bearer
403 Key ត្រឹមត្រូវ ប៉ុន្តែ account មិនមាន Pro active (Pro plan required for API access)

សូមផ្ញើ Accept: application/json ជានិច្ច។

Rate limiting

  • 60 requests ក្នុងមួយនាទី ក្នុងមួយ API key
  • Window: 60 វិនាទី
  • Counter ត្រូវបាន ចែករំលែក រវាង Public API endpoints ទាំងអស់ និង MCP

Successful responses មាន headers ខាងក្រោម:

Header Description
X-RateLimit-Limit Limit (60)
X-RateLimit-Remaining ចំនួន requests នៅសល់ក្នុង window បច្ចុប្បន្ន
X-RateLimit-Reset Unix timestamp ពេល window reset

ពេលលើស limit: 429 Too Many Requests និង header Retry-After (វិនាទីសម្រាប់ retry)។

គន្លឹះ: ប្រើ page_size ដល់ 50 សម្រាប់ lists; កុំ poll POST /search ញឹកញាប់ពេក — responses ត្រូវបាន cache (មើល “Caching”)។

Daily row quota

  • 50,000 list rows per day per account (API key / signed-in user)
  • Reset: UTC midnight
  • Counter is shared across Public API list endpoints, MCP list tools, web UI tables, and CSV export

Each list request charges page_size rows (the requested page size, not total_count).

Successful list responses include headers:

Header Description
X-Quota-Limit Daily limit (50000)
X-Quota-Remaining Rows left today
X-Quota-Reset Unix timestamp when the daily quota resets

When the quota is exceeded: 429 Too Many Requests and Retry-After (seconds until reset).

Pagination depth: for a single search/filter, page × page_size must not exceed 5000 (e.g. with page_size=50, max page is 100). This limits deep scraping of one result set; the daily quota caps total volume across all queries.

Endpoint overview

Query/body parameters ពេញលេញ — នៅ OpenAPI។

Method Path Purpose
POST /v1/reports/search Search reports តាម ReportListFilterSchema body, pagination, sorting
GET /v1/reports/favorites បញ្ជី favorite reports របស់អ្នកប្រើបច្ចុប្បន្ន
POST /v1/reports/favorites បន្ថែម report ទៅ favorites
DELETE /v1/reports/favorites/{report_type}/{report_id} ដកចេញពី favorites
GET /v1/reports/by-domain/{domain} រក report IDs តាម domain name ត្រឹមត្រូវពិត
GET /v1/reports/{report_type}/{report_id} Full report តាម database type និង report id
GET /v1/reports/check/expired/{report_id} ពិនិត្យថា domain បាន drop សម្រាប់ expired report ឬអត់
GET /v1/user User profile (PublicUserProfileSchema)
GET /v1/domains/checker/expiry/{domain} Live check: domain អាចចុះឈ្មោះបានឬអត់
GET /v1/domains/checker/karma_metric/{domain} Live Karma Metric calculation តាម WayBack Machine

Model parameters reference

ខាងក្រោមជាផែនទី parameter កម្រិតអនុវត្តសម្រាប់ OpenAPI models សំខាន់ 3 ដែលកំណត់សមត្ថភាព API ភាគច្រើន។

ReportListFilterSchema (request body សម្រាប់ POST /v1/reports/search)

Semantics នៃតម្លៃក្នុង schema នេះ:

  • null ឬមិនផ្ញើ field = មិនដាក់ filter។
  • String query fields គាំទ្រ , សម្រាប់ AND និង | សម្រាប់ OR នៅកន្លែងដែលបាន doc។
  • Date ranges ជា array មាន strings 2: [from, to]។
  • Score ranges ភាគច្រើនប្រើ *_min / *_max បែប inclusive។
Parameter Type Description
domain string | null Filter តាម substring ដូមេន (case-insensitive)។ , = AND, | = OR។ Max length: 350
tlds string | null បញ្ជី TLD បំបែកដោយ comma ឬ space (ឧ. .com .net .org)។ Max length: 350
domain_type string[] | null Allowed: auctions, backorder, buynow, expired; OR logic រវាង values
favorites boolean | null true = favorites only, false = exclude favorites; ត្រូវការបរិបទ authenticated user
categories string[] | null OR logic តាម category; គាំទ្រ Category / Subcategory; case-insensitive substring
languages string Language query ដោយ , (AND) / | (OR); case-insensitive; max length: 350
keywords string | null Search ក្នុង Wayback content (title, description, h1-h6, …); , = AND, | = OR; max length: 350
website_ids string[] IDs ដូច GA/Metrika សម្រាប់រក domains owner ដូចគ្នា
domain_length_min / domain_length_max integer | null Boundaries ប្រវែងដូមេន (1..30)
domain_numbers / domain_hyphens boolean Require/exclude លេខ និង hyphen ក្នុង domain name
report_added_time string[2] | null Date range: ["YYYY-MM-DD","YYYY-MM-DD"]
karmascore_min / karmascore_max integer | null KarmaScore bounds 0..100
karmametric_min / karmametric_max integer | null Karma Metric bounds 0..100
brandscore_min / brandscore_max integer | null Brandscore bounds 0..100
openpagerank_min / openpagerank_max integer | null Open PageRank bounds 0..10
ahrefs_dr_min / ahrefs_dr_max number | null Ahrefs DR bounds 0..100
ahrefs_ur_min / ahrefs_ur_max number | null Ahrefs UR bounds 0..100
ahrefs_ar_min / ahrefs_ar_max integer | null Ahrefs Rank bounds (>= 0)
majestic_tf_min / majestic_tf_max integer | null Majestic TF bounds 0..100
majestic_cf_min / majestic_cf_max integer | null Majestic CF bounds 0..100
majestic_bl_min / majestic_bl_max integer Majestic backlinks bounds
majestic_rd_min / majestic_rd_max integer Majestic referring domains bounds
majestic_topics / majestic_lang string[] / string Topics និង anchor-language filters
moz_da_min / moz_da_max integer | null Moz DA bounds 0..100
moz_ss_min / moz_ss_max integer | null Moz Spam Score bounds 0..100
moz_bl_min / moz_bl_max integer Moz backlinks bounds
moz_rd_min / moz_rd_max integer Moz referring domains bounds
moz_bl_url / moz_bl_anchor string Moz backlink URL / anchor filters
sw_visits_min / sw_visits_max integer SimilarWeb visits bounds
sw_last_traffic_date string[2] | null SimilarWeb month range: ["YYYY-MM","YYYY-MM"]
sw_country_filters object[] Country share filters (country, optional share_min)
sw_ts_direct_min...sw_ts_social_max number | null Traffic-source channel share bounds 0..100
wa_age_min / wa_age_max integer | null Wayback domain age in years
wa_first_snap / wa_last_snap string[2] | null Date range សម្រាប់ first/last snapshot windows
wa_changes_min/max, wa_redirects_min/max, wa_parkings_min/max integer Wayback history counters
wa_hieroglyphs, wa_redirects, wa_error403 boolean Wayback content quality flags
wa_lang_filters object[] Wayback language filters (language, optional ratio_min)
wa_server_code, wa_server_code_ratio_min/max integer | null / number | null Wayback server code + ratio bounds
ke_etv_min/max, ke_total_min/max integer Keywords Everywhere value/keyword bounds
ke_keyword string Keywords Everywhere phrase filter
google_has_index, google_has_mentions boolean | null Require index/mentions ក្នុង Google SERP
google_title_index/mentions, google_description_index/mentions string SERP snippet phrase filters
trustpilot_rating_min/max, trustpilot_reviews_count_min/max number | null / integer | null Trustpilot bounds
trustpilot_category string Trustpilot category filter
auction_source string[] | null Source name ឬ `source
auction_end_time, auction_added_time string[2] | null Date range
auction_price_min/max number Auction price bounds
auction_bids_min/max integer Auction bids bounds
combine_seo object | null Cross-vendor CombineSEOFilter

ReportListResponseSchema (response សម្រាប់ POST /search និង GET /favorites)

Parameter Type Description
report_list ReportItem[] បញ្ជីជួរដេកដែលបែងចែកទំព័រ
total_count integer ចំនួនសរុបនៃ records ដែលត្រូវនឹង filter

report_list[] ជាផ្នែក ReportItem រួមមាន fields ដូចជា report_id, report_type, domain fields, state flags, SEO summaries, traffic summaries, និង auctions summaries។

ReportFullResponseSchema (response សម្រាប់ GET /v1/reports/{report_type}/{report_id})

ផ្ទុក identity fields, domain structure fields, state flags, lifecycle timestamps, provider status, និង blocks សំខាន់ៗ:

  • web_archive
  • metrics (DomainMetrics)
  • auctions

metrics → DomainMetrics

Provider blocks អាចជា object, false, ឬ null; categories និង blacklists អាចជា []។

Key fields រួមមាន openpagerank, categories, blacklists, ahrefs, majestic, moz, keywordseverywhere, similarweb, brandscore, karma_metric, trustpilot, google, ai_summary។

For nested types (AhrefsData, MajesticData, MozData, KeywordseverywhereData, SimilarWebData, BrandscoreData, KarmaMetricData, TrustpilotData, GoogleData) សូមយោង OpenAPI សម្រាប់ constraints និង nullability ពិតប្រាកដ។

web_archive (Wayback Machine payload)

មាន 3 blocks: info, ts_summary, history។ ក្នុង full report, history ត្រឡប់ newest-first។

auctions (auction lots)

ក្នុង full report lots ត្រូវបាន group តាម end_time key។

{
  "1764441900": [
    { "source": "godaddy", "sale_type": "auction", "price": 120, "bids": 3, "...": "..." }
  ]
}

Filter tip: auction_source អាចជា godaddy ឬ godaddy|auction។

សម្រាប់ field constraints ច្បាស់លាស់ សូមប្រើ OpenAPI ឬ ReDoc។

report_type parameter

សម្រាប់ full report និង favorites: auctions, expired, backorder, buynow។
all ប្រើបានតែក្នុង search logic មិនអាចប្រើជា {report_type} ក្នុង path ទេ។

Pagination and sorting (list endpoints)

Parameter Default Description
page 1 លេខទំព័រ
page_size 10 ទំហំទំព័រ (អតិបរមា 50)
sort_by added_at ឈ្មោះ column សម្រាប់ sort
sort_desc true true = ចុះក្រោម

Depth limit: page × page_size ≤ 5000. Requests beyond this return 422 validation error.

Domains in URLs

សម្រាប់ {domain} ក្នុង path ត្រូវប្រើ percent-encoding (IDN, Cyrillic, …)។ Server នឹង normalize ទៅ lowercase/punycode។

Typical workflows

1. Search → full report

  1. POST /v1/reports/search ជាមួយ filter body
  2. ពី report_list[] យក report_id និង report_type
  3. GET /v1/reports/{report_type}/{report_id}

2. Exact domain lookup

  1. GET /v1/reports/by-domain/example.com
  2. ពិនិត្យ matches[]
  3. ជ្រើស report_type ហើយ GET /v1/reports/{report_type}/{report_id}

3. Favorites

  • GET /v1/reports/favorites
  • POST /v1/reports/search ជាមួយ "favorites": true
  • POST /v1/reports/favorites
  • DELETE /v1/reports/favorites/expired/{report_id}

4. Expired drop check

GET /v1/reports/check/expired/{report_id} (ប្រើ report id មិនមែន domain name)។

5. Domain availability check

GET /v1/domains/checker/expiry/{domain} (live WHOIS/DNS)។

6. Karma Metric on the fly

GET /v1/domains/checker/karma_metric/{domain}។

7. Balance and plan

GET /v1/user សម្រាប់ profile/balance/plan/subscription។

Caching

Public API cache table:

Endpoint TTL
POST /v1/reports/search 5 min
GET /v1/reports/favorites 5 min
POST /v1/reports/favorites none
DELETE /v1/reports/favorites/{report_type}/{report_id} none
GET /v1/reports/by-domain/{domain} 5 min
GET /v1/reports/check/expired/{report_id} 1 h
GET /v1/reports/{report_type}/{report_id} none
GET /v1/user 1 min
GET /v1/domains/checker/expiry/{domain} 1 h
GET /v1/domains/checker/karma_metric/{domain} 1 h

POST/DELETE favorites ប្រែប្រួលភ្លាមៗ ប៉ុន្តែ list endpoints អាចយឺតរហូតដល់ cache timeout។

Request examples (curl)

ជំនួស YOUR_API_KEY ជា key ផ្ទាល់ខ្លួន។

Search expired with a filter

curl -X POST "https://api.karma.domains/v1/reports/search?page=1&page_size=25&sort_by=added_at&sort_desc=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "karmascore_min": 60,
    "domain_type": ["expired"]
  }'

Full report

curl "https://api.karma.domains/v1/reports/expired/507f1f77bcf86cd799439011" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Lookup by domain

curl "https://api.karma.domains/v1/reports/by-domain/example.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Add to favorites

curl -X POST "https://api.karma.domains/v1/reports/favorites" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "report_id": "507f1f77bcf86cd799439011",
    "report_type": "expired"
  }'

Domain availability check

curl "https://api.karma.domains/v1/domains/checker/expiry/mybrand.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Karma Metric

curl "https://api.karma.domains/v1/domains/checker/karma_metric/mybrand.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Integration use cases

Nightly expired selection pipeline

ប្រើ cron រៀងរាល់ថ្ងៃ + saved JSON filter + pagination + export report_id ទៅ DB ផ្ទាល់ខ្លួន។

Monitoring a name list before registration

Queue ដូមេន → GET /domains/checker/expiry/{domain} → branching តាម available។

Syncing favorites with internal CRM

Pull GET /favorites ជាប្រចាំ ហើយ push actions តាម POST/DELETE។

BI / funnel analytics

ប្រមូល total_count និង metrics ពី report_list។

MCP + scripts on one key

ប្រើ MCP សម្រាប់ ad-hoc និង REST សម្រាប់ ETL; គ្រប់គ្រង 429 ដោយ backoff។

MCP and Public API

Public API (REST) MCP
Audience Developers, scripts, ETL AI assistants
Interface HTTP + JSON Dialogue, tools
Docs This page + OpenAPI /km/expired-domains-mcp/
Data Same reports and databases Same
Key & limit Shared Shared

សម្រាប់ code integration ថ្មីៗ ចាប់ផ្តើមពី REST; សម្រាប់ chat experiments ប្រើ MCP។

FAQ

Full filter reference នៅណា?

នៅ OpenAPI, schema ReportListFilterSchema។

available និង is_expired ខុសគ្នាយ៉ាងដូចម្តេច?

ទាំងពីរនេះមានន័យថា domain អាចចុះឈ្មោះបាន (ប្រហែល) ក្នុងបរិបទ API។

ហេតុអ្វី 403 ទោះ key ត្រឹមត្រូវ?

គ្មាន Pro active។

ហេតុអ្វី response មិនដូច UI?

ដោយសារតែ caching TTL។

sort_by អនុញ្ញាត values អ្វីខ្លះ?

មើល enum ក្នុង OpenAPI។

ត្រូវការទំព័រនេះទៀតទេ បើមាន OpenAPI?

OpenAPI ជា source of truth សម្រាប់ types/fields; ទំព័រនេះផ្តល់ context ការប្រើប្រាស់ជាក់ស្តែង។

Can I export the entire database via the API?

No. A single search is limited to 5000 rows of pagination depth, and your account can retrieve at most 50,000 list rows per day (UTC) across API, MCP, and UI. Use filters to narrow results; fetch full reports one domain at a time via GET /reports/{report_type}/{report_id}.

មាន sandbox ទេ?

មិនមាន sandbox ដាច់ដោយឡែកទេ; ប្រើ Pro account។

Error codes

Code Meaning
200 Success
401 Unauthorized (key)
403 No Pro
404 Report or resource not found
422 Body/query validation error
429 Rate limit or daily row quota exceeded
503 Rate limiter or row quota service temporarily unavailable

Error body ជាទូទៅមាន detail។ ឧទាហរណ៍:

{
  "detail": "Invalid API key"
}

Public API Karma.Domains ផ្តល់នូវការចូលដំណើរការតាមកម្មវិធីទៅកាន់របាយការណ៍ដែន៖ ការដេញថ្លៃ ផុតកំណត់ បញ្ជាទិញវិញ និងទិញឥឡូវនេះ។ ការឆ្លើយតបទាំងអស់គឺ JSON លើ HTTPS ។ URL មូលដ្ឋាន៖ https://api.karma.domains បុព្វបទផ្លូវ៖ /v1។

Karma.Domains គឺជាវេទិកាស៊ើបការណ៍ដែនសម្រាប់វិនិយោគិន ក្រុម SEO និងបំពង់ស្វ័យប្រវត្តិកម្ម៖

  • ** 400,000+ ដែនថ្មីប្រចាំថ្ងៃ** នៅក្នុងការស្វែងរក និងតាមដានលំហូរ (សរុប 7,000,000+ domains)
  • ** ប្រភពទិន្នន័យ 30+ domain** រួមរួមទាំង 27+ ដេញថ្លៃ/ផុតកំណត់/backorder/buy-now ប្រភព (GoDaddy, NameJet, DropCatch, Dynadot, GNAME, Namecheap ។ល។)
  • ** 90+ តម្រង** សម្រាប់ការស្វែងរកច្បាស់លាស់លើគុណភាពដែន SEO ប្រវត្តិមាតិកា និងសញ្ញាដេញថ្លៃ (TF, CF, DA, DR, Age, Backlinks, Traffic, Keywords, Anchor Text ។ល។)
  • ការធានារ៉ាប់រង TLD និង ccTLD (ឧទាហរណ៍ .com, .net, .org, .biz, .info, .at, .be, .ca, __TOK8_0_9, _TOK8_0, .co.nz)
  • SEO និងទិន្នន័យអាជ្ញាធរពីអ្នកលក់ធំៗ៖ Ahrefs, Majestic, Moz, SimilarWeb
  • ខ្លឹមសារប្រវត្តិសាស្ត្រ និងការផ្លាស់ប្តូរសញ្ញាតាមរយៈ Wayback Machine

គ្រោងការណ៍សំណើ និងការឆ្លើយតប (វាលតម្រង រចនាសម្ព័ន្ធរបាយការណ៍ តម្រៀប enums) — នៅក្នុងឯកសារអន្តរកម្ម៖ Swagger UI ឬ ReDoc។ ទំព័រនេះគឺជាទិដ្ឋភាពទូទៅនៃការរួមបញ្ចូល៖ ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ ដែនកំណត់ បញ្ជីចំណុចបញ្ចប់ លំហូរការងារធម្មតា និងឧទាហរណ៍។

សេចក្តីផ្តើម

Public API គឺសម្រាប់ស្គ្រីប ផ្ទាំងគ្រប់គ្រងខាងក្នុង ប្រព័ន្ធ CRM និងស្វ័យប្រវត្តិកម្មណាមួយដែលត្រូវការទិន្នន័យដូចគ្នាទៅនឹងកម្មវិធីបណ្តាញ Karma.Domains ។

  • ** ទម្រង់៖ ** JSON
  • ** កំណែ API៖ ** 1.0.0
  • ** មូលដ្ឋានទិន្នន័យ៖** auctions, expired, backorder, buynow; ស្វែងរកទាំងអស់ក្នុងពេលតែមួយ — POST /v1/reports/search (ដូចគ្នានឹងតារាង "មូលដ្ឋានទិន្នន័យទាំងអស់" នៅក្នុង UI)
  • ឯកសារវាល៖ តែនៅក្នុង OpenAPI
  • មានតែនៅលើ Pro plan and above ប៉ុណ្ណោះ

ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ

រាល់សំណើត្រូវតែរួមបញ្ចូលបឋមកថា៖

Authorization: Bearer YOUR_API_KEY

វិធីដើម្បីទទួលបានសោ API

  1. គម្រោង Pro (បើគ្មាន Pro នោះ API មិនអាចប្រើបានទេ)។
  2. Profile → Settings — បង្កើត ឬកំណត់សោឡើងវិញនៅក្នុងផ្នែក API key។

សោដូចគ្នាត្រូវបានប្រើសម្រាប់ MCP server (ជំនួយការ AI)។ ដែនកំណត់សំណើគឺ ចែករំលែក រវាង REST និង MCP។

ការឆ្លើយតបធម្មតានៅពេលដែលសោខុស

កូដ ហេតុផល
៤០១ បាត់បឋមកថា សោមិនត្រឹមត្រូវ ឬវាយអក្សរនៅក្នុង Bearer
៤០៣ សោមានសុពលភាព ប៉ុន្តែគណនីមិនមានសកម្មភាព Pro (Pro plan required for API access)

ផ្ញើ Accept: application/json ជានិច្ច។

ការកំណត់អត្រា

  • ** 60 សំណើក្នុងមួយនាទី ** ក្នុងមួយសោ API
  • បង្អួច៖ ៦០ វិនាទី
  • Counter ត្រូវបាន ចែករំលែក នៅទូទាំង Public API endpoints និង MCP

ការឆ្លើយតបដោយជោគជ័យរួមមានចំណងជើង៖

បឋមកថា ការពិពណ៌នា
X-RateLimit-Limit ដែនកំណត់ (60)
X-RateLimit-Remaining សំណើដែលនៅសល់ក្នុងបង្អួចបច្ចុប្បន្ន
X-RateLimit-Reset ការបោះត្រាពេលវេលាយូនីកនៅពេលដែលបង្អួចកំណត់ឡើងវិញ

នៅពេលដែលលើសពីដែនកំណត់៖ 429 សំណើច្រើនពេក និង Retry-After បឋមកថា (វិនាទីរហូតដល់ព្យាយាមម្តងទៀត)។

** គន្លឹះ៖** ប្រើ page_size រហូតដល់ 50 សម្រាប់បញ្ជី។ កុំស្ទង់មតិ POST /search ញឹកញាប់ជាងតម្រូវការ — ការឆ្លើយតបត្រូវបានទុកក្នុងឃ្លាំងសម្ងាត់ (សូមមើល "ឃ្លាំងសម្ងាត់") ។

ទិដ្ឋភាពទូទៅនៃចំណុចបញ្ចប់

សំណួរពេញ/ប៉ារ៉ាម៉ែត្រតួ — ក្នុង OpenAPI។

វិធីសាស្រ្ត ផ្លូវ គោលបំណង
POST /v1/reports/search ស្វែងរករបាយការណ៍ដោយ ReportListFilterSchema តួ, pagination, តម្រៀប
GET /v1/reports/favorites បញ្ជីរបាយការណ៍ដែលចូលចិត្តរបស់អ្នកប្រើប្រាស់បច្ចុប្បន្ន
POST /v1/reports/favorites បន្ថែមរបាយការណ៍ទៅចំណូលចិត្ត
DELETE /v1/reports/favorites/{report_type}/{report_id} យកចេញពីចំណូលចិត្ត
GET /v1/reports/by-domain/{domain} ស្វែងរកលេខសម្គាល់របាយការណ៍ដោយ ** ឈ្មោះដែន ** ពិតប្រាកដ
GET /v1/reports/{report_type}/{report_id} របាយការណ៍ពេញលេញតាមប្រភេទមូលដ្ឋានទិន្នន័យ និងលេខសម្គាល់របាយការណ៍
GET /v1/reports/check/expired/{report_id} ពិនិត្យមើលថាតើដែនបានធ្លាក់ចុះសម្រាប់របាយការណ៍ ផុតកំណត់ ដែរឬទេ
GET /v1/user កម្រងព័ត៌មានអ្នកប្រើប្រាស់ (PublicUserProfileSchema)
GET /v1/domains/checker/expiry/{domain} ពិនិត្យផ្ទាល់៖ ថាតើដែនមានដើម្បីចុះឈ្មោះដែរឬទេ
GET /v1/domains/checker/karma_metric/{domain} ការគណនា Karma Metric ផ្ទាល់តាមរយៈម៉ាស៊ីន WayBack

ប៉ារ៉ាម៉ែត្រគំរូយោង

ខាងក្រោមនេះគឺជាផែនទីកម្រិតប៉ារ៉ាម៉ែត្រជាក់ស្តែងសម្រាប់ម៉ូដែល OpenAPI ស្នូល 3 ដែលកំណត់សមត្ថភាព API ភាគច្រើន។

ReportListFilterSchema (ស្នើសុំតួសម្រាប់ POST /v1/reports/search)

តម្លៃន័យធៀបដែលប្រើក្នុងគ្រោងការណ៍នេះ៖

  • null ឬវាលដែលបានលុប = គ្មានតម្រង។
  • វាលសំណួរខ្សែអក្សរគាំទ្រ , សម្រាប់ AND និង | សម្រាប់ OR ដែលជាកន្លែងដែលត្រូវបានចងក្រងជាឯកសារ។
  • ជួរកាលបរិច្ឆេទគឺជាអារេនៃ 2 ខ្សែ៖ [from, to] ។
  • ជួរពិន្ទុភាគច្រើនប្រើ *_min / *_max រួមបញ្ចូល។
ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
domain ខ្សែអក្សរ |null តម្រង​ខ្សែអក្សរ​រង​ដែន មិន​ប្រកាន់​អក្សរតូចធំ។ , = AND (លក្ខខណ្ឌទាំងអស់ត្រូវតែផ្គូផ្គង), | = ឬ (ពាក្យណាមួយ) ។ ប្រវែងអតិបរមា៖ ៣៥០ ។
tlds ខ្សែអក្សរ |null បញ្ជី TLD បំបែកដោយសញ្ញាក្បៀស ឬដកឃ្លា (ឧ. .com .net .org)។ ប្រវែងអតិបរមា៖ ៣៥០ ។
domain_type ខ្សែអក្សរ[] \|null តម្លៃដែលបានអនុញ្ញាត៖ auctions, backorder, buynow, expired។ ឬតក្កវិជ្ជារវាងតម្លៃដែលបានជ្រើសរើស។
favorites ប៊ូលីន |null true=តែ​ចំណូលចិត្ត, false=មិន​រាប់​បញ្ចូល​ចំណូលចិត្ត។ ទាមទារបរិបទអ្នកប្រើប្រាស់ដែលបានផ្ទៀងផ្ទាត់។
categories ខ្សែអក្សរ[] \|null ឬតក្កវិជ្ជាតាមប្រភេទ គាំទ្រទ្រង់ទ្រាយ Category / Subcategory ការផ្គូផ្គងខ្សែអក្សររងដែលមិនប្រកាន់អក្សរតូចធំ។
languages string សំណួរភាសាជាមួយ , (AND) / | (OR) ការផ្គូផ្គងខ្សែអក្សររងដែលមិនប្រកាន់អក្សរតូចធំ។ ប្រវែងអតិបរមា៖ ៣៥០ ។
keywords ខ្សែអក្សរ |null ស្វែងរកក្នុងខ្លឹមសារ Wayback (title, description, h1-h6 ។ល។)។ , = AND, | = OR ។ ប្រវែងអតិបរមា៖ ៣៥០ ។
website_ids string[] លេខសម្គាល់ដូចជា GA/Metrika ដើម្បីស្វែងរកដែនដែលមានម្ចាស់ដូចគ្នា។
domain_length_min / domain_length_max ចំនួនគត់ |null ព្រំដែនប្រវែងដែន (ចងក្រងជា 1..30)។
domain_numbers / domain_hyphens boolean ទាមទារ/មិនរាប់បញ្ចូលលេខ និងសហសញ្ញានៅក្នុងឈ្មោះដែន។
report_added_time ខ្សែអក្សរ[2] \|null ជួរកាលបរិច្ឆេទ៖ ["YYYY-MM-DD","YYYY-MM-DD"] ។ កម្មវិធីខាងក្រោយអនុវត្តព្រំដែនថ្ងៃចាប់ផ្តើម/ថ្ងៃបញ្ចប់ដោយស្វ័យប្រវត្តិ។
karmascore_min / karmascore_max ចំនួនគត់ |null ព្រំដែន KarmaScore, 0..100 ។
karmametric_min / karmametric_max ចំនួនគត់ |null Karma Metric bounds, 0..100 ។
brandscore_min / brandscore_max ចំនួនគត់ |null ព្រំដែនពិន្ទុម៉ាក, 0..100 ។
openpagerank_min / openpagerank_max ចំនួនគត់ |null បើកព្រំដែន PageRank ដែលចងក្រងជា 0..10 ។
ahrefs_dr_min / ahrefs_dr_max លេខ|null Ahrefs DR bounds, 0..100 ។
ahrefs_ur_min / ahrefs_ur_max លេខ|null Ahrefs UR bounds, 0..100 ។
ahrefs_ar_min / ahrefs_ar_max ចំនួនគត់ |null Ahrefs Rank bounds (>= 0)។
majestic_tf_min / majestic_tf_max ចំនួនគត់ |null Majestic TF bounds, 0..100 ។
majestic_cf_min / majestic_cf_max ចំនួនគត់ |null Majestic CF bounds, 0..100 ។
majestic_bl_min / majestic_bl_max integer ព្រំដែន backlinks ដ៏អស្ចារ្យ។
majestic_rd_min / majestic_rd_max integer ដែន​យោង​ដ៏​អស្ចារ្យ​មាន​ព្រំដែន។
majestic_topics / majestic_lang string[] / string តម្រងប្រធានបទ និងយុថ្កា-ភាសា។
moz_da_min / moz_da_max ចំនួនគត់ |null Moz DA bounds, 0..100 ។
moz_ss_min / moz_ss_max ចំនួនគត់ |null Moz Spam Score bounds, 0..100 ។
moz_bl_min / moz_bl_max integer Moz backlinks ព្រំដែន។
moz_rd_min / moz_rd_max integer Moz យោង​ដែន​កំណត់។
moz_bl_url / moz_bl_anchor string Moz backlink URL / តម្រងឃ្លាយុថ្កា។
sw_visits_min / sw_visits_max integer ព្រំដែននៃការចូលមើលគេហទំព័រស្រដៀងគ្នា។
sw_last_traffic_date ខ្សែអក្សរ[2] \|null ជួរខែស្រដៀងគ្នានៃគេហទំព័រ៖ ["YYYY-MM","YYYY-MM"] ។
sw_country_filters object[] តម្រងចែករំលែកប្រទេស (country ជាជម្រើស share_min)។
sw_ts_direct_min...sw_ts_social_max លេខ|null SimilarWeb traffic-source share bounds, 0..100.
wa_age_min / wa_age_max ចំនួនគត់ |null អាយុដែន Wayback ជាឆ្នាំ។
wa_first_snap / wa_last_snap ខ្សែអក្សរ[2] \|null ជួរកាលបរិច្ឆេទ៖ ["YYYY-MM-DD","YYYY-MM-DD"] សម្រាប់បង្អួចរូបថតដំបូង/ចុងក្រោយ។
wa_changes_min/max, wa_redirects_min/max, wa_parkings_min/max integer ប្រវតិ្តសាស្រ្តនៃការថយក្រោយ។
wa_hieroglyphs, wa_redirects, wa_error403 boolean ទង់គុណភាពមាតិកា Wayback ។
wa_lang_filters object[] តម្រងភាសា Wayback (language ជាជម្រើស ratio_min)។
wa_server_code, wa_server_code_ratio_min/max ចំនួនគត់ |null / លេខ |null តម្រងកូដម៉ាស៊ីនមេ Wayback (ឧ. 200, 301, 302, 403, 404) + សមាមាត្រព្រំដែន 0..100 ។
ke_etv_min/max, ke_total_min/max integer ពាក្យគន្លឹះគ្រប់ទីកន្លែង តម្លៃចរាចរណ៍ / ពាក្យគន្លឹះកំណត់។
ke_keyword string ពាក្យគន្លឹះ តម្រងឃ្លាគ្រប់ទីកន្លែង។
google_has_index, google_has_mentions ប៊ូលីន |null true/false/unset semantics សម្រាប់ទាមទារលិបិក្រម ឬការលើកឡើងនៅក្នុង Google SERP ។
google_title_index/mentions, google_description_index/mentions string តម្រងឃ្លាចំណងជើង/ពិពណ៌នាសង្ខេប SERP ។
trustpilot_rating_min/max, trustpilot_reviews_count_min/max លេខ|null / ចំនួនគត់ |null Trustpilot rating bounds (0..5) និងការពិនិត្យឡើងវិញរាប់ព្រំដែន។
trustpilot_category string តម្រងឃ្លាប្រភេទ Trustpilot ។
auction_source ខ្សែអក្សរ[] \|null ឈ្មោះប្រភពដេញថ្លៃ (មិនប្រកាន់អក្សរតូចធំ) ឬតម្លៃផ្សំ `ប្រភព
auction_end_time, auction_added_time ខ្សែអក្សរ[2] \|null ជួរកាលបរិច្ឆេទ៖ ["YYYY-MM-DD","YYYY-MM-DD"] ។
auction_price_min/max number ដែនកំណត់តម្លៃដេញថ្លៃ។
auction_bids_min/max integer ការដេញថ្លៃរាប់ចំនួនព្រំដែន។
combine_seo វត្ថុ |null អ្នកលក់ឆ្លង CombineSEOFilter៖ authority/backlinks/refdomains/traffic/keywords/backlink-url/យុថ្កា ជាមួយនឹង vendor-scoped OR logic ក្នុងជួរនីមួយៗ និង AND រវាងជួរដេក។

ReportListResponseSchema (ការឆ្លើយតបសម្រាប់ POST /search និង GET /favorites)

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
report_list ReportItem[] ជួរដេកដែលបានបិទភ្ជាប់សម្រាប់ការមើលតារាង និងការបង្កើតបញ្ជីសម្រាំង។
total_count integer ចំនួនសរុបនៃកំណត់ត្រាដែលត្រូវគ្នាសម្រាប់តម្រងបច្ចុប្បន្ន។

report_list[] វាលកម្រិតជួរ (ពី ReportItem) រួមមាន៖

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
report_id string ការកំណត់អត្តសញ្ញាណរបាយការណ៍ដែលមានស្ថេរភាព (ប្រើសម្រាប់របាយការណ៍ពេញលេញ និងចំណូលចិត្ត)។
report_type string មួយក្នុងចំណោម auctions, expired, backorder, buynow។
domain, domain_tld string ឈ្មោះដែន និង TLD ។
added_at, updated_at integer ត្រាពេលវេលា។
processed, demo, is_expired boolean ទង់រដ្ឋដែលប្រើក្នុងលំហូរការងារ UI/API ។
karmascore, karmametric, brandscore integer គុណភាពស្នូល/រង្វាស់ម៉ាកយីហោ។
ahrefs_dr, ahrefs_ur number រង្វាស់សង្ខេបរបស់ Ahrefs ។
majestic_tf/cf/bl/rd, moz_da/ss/bl/rd integer រង្វាស់សង្ខេប Majestic និង Moz ។
ke_etv, ke_total integer ពាក្យគន្លឹះ គ្រប់ទីកន្លែង តម្លៃសង្ខេប។
sw_last_traffic, sw_country_share, sw_sources integer/object សេចក្តីសង្ខេបចរាចរណ៍គេហទំព័រស្រដៀងគ្នា។
wa_age, wa_last_snap, wa_changes, wa_langs, wa_server_code integer/array សញ្ញា​សង្ខេប​នៃ​ការ​ថយ​ក្រោយ។
google_index, trustpilot_rating, trustpilot_reviews_count boolean/number/integer វាលសង្ខេប Google/Trustpilot ។
auctions array/object សេចក្តីសង្ខេបការដេញថ្លៃប្រសិនបើមាន។

ReportFullResponseSchema (ការឆ្លើយតបសម្រាប់ GET /v1/reports/{report_type}/{report_id})

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
report_id, report_type, domain, domain_tld string វាលអត្តសញ្ញាណស្នូល។
domain_length, domain_numbers, domain_hyphens integer/boolean លក្ខណៈរចនាសម្ព័ន្ធដែន។
favorite, demo, processed, is_expired boolean រាយការណ៍អំពីស្ថានភាព និងទង់ដែលទាក់ទងនឹងអ្នកប្រើប្រាស់។
added_at, updated_at, created_at, checked_at, expire_checked_at integer ត្រាពេលវេលាវដ្តជីវិត។
providers_status object ផែនទីស្ថានភាពដំណើរការរបស់អ្នកផ្តល់សេវា (តម្លៃខ្សែអក្សរ)។
web_archive object ទិន្នន័យម៉ាស៊ីន Wayback — សូមមើលការវិភាគខាងក្រោម។
metrics DomainMetrics Nested SEO/traffic/reputation metrics — សូមមើលការវិភាគខាងក្រោម។
auctions វត្ថុ |null ការដេញថ្លៃដាក់ជាក្រុមដោយ end_time — សូមមើលការវិភាគខាងក្រោម។

metrics → DomainMetrics

ប្លុកអ្នកផ្តល់សេវាភាគច្រើនអាចជាវត្ថុដែលមានទិន្នន័យ false (មិនផ្ទុក) ឬ null ។ categories និង blacklists ក៏អាចជា [] នៅពេលទំនេរ។

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
openpagerank លេខ|ចំនួនគត់ |ប៊ូលីន \|null បើកពិន្ទុ PageRank (ជាធម្មតា 0..10) នៅពេលមាន។
categories CategoryData[] \|ប៊ូលីន \|null ប្រភេទមាតិកាពីអ្នកផ្តល់ចំណាត់ថ្នាក់។
blacklists ទិន្នន័យបញ្ជីខ្មៅ[] \|ប៊ូលីន \|null សុវត្ថិភាព/កេរ្តិ៍ឈ្មោះ ធ្លាក់ចូលក្នុងបញ្ជីខ្មៅ។
ahrefs AhrefsData |ប៊ូលីន \|null រង្វាស់ដែន Ahrefs ។
majestic MajesticData |ប៊ូលីន \|null Majestic Trust/Citation Flow និងទម្រង់ backlink ។
moz MozData |ប៊ូលីន \|null សិទ្ធិអំណាច Moz ពិន្ទុសារឥតបានការ និងព័ត៌មានលម្អិត backlink ។
keywordseverywhere ពាក្យ​គន្លឹះ​គ្រប់​ទីកន្លែង​ទិន្នន័យ |ប៊ូលីន \|null ពាក្យគន្លឹះ គ្រប់ទីកន្លែងចរាចរណ៍/ការប៉ាន់ស្មានពាក្យគន្លឹះ។
similarweb ទិន្នន័យគេហទំព័រស្រដៀងគ្នា |ប៊ូលីន \|null ការចូលមើលគេហទំព័រ ប្រភព និងការចែករំលែកភូមិសាស្ត្រស្រដៀងគ្នា។
brandscore ទិន្នន័យម៉ាកយីហោ |ប៊ូលីន \|null សមាសធាតុពិន្ទុម៉ាកយីហោ។
karma_metric KarmaMetricData |ប៊ូលីន \|null ពិន្ទុ Karma Metric ពីប្រវត្តិ Wayback ។
trustpilot ទិន្នន័យ Trustpilot|ប៊ូលីន \|null ការវាយតម្លៃអ្នកបើកយន្តហោះ និងពិនិត្យមើលស្ថិតិ។
google ទិន្នន័យ Google |ប៊ូលីន \|null លិបិក្រម Google និងលើកឡើងពីអត្ថបទ SERP ។
ai_summary ខ្សែអក្សរ |null អត្ថបទសង្ខេបដែនដែលបង្កើតដោយ AI ។

AhrefsData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
domain_rating លេខ|null Ahrefs DR.
url_rating លេខ|ចំនួនគត់ |null Ahrefs UR ។
ahrefs_rank ចំនួនគត់ |null ចំណាត់ថ្នាក់ Ahrefs (ទាបជាង = ខ្លាំងជាង) ។

MajesticData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
tf, cf ចំនួនគត់ |null Trust Flow/Citation Flow (0..100)។
backlinks, refdomains ចំនួនគត់ |null Backlinks និងដែនយោងរាប់។
primary_topic ខ្សែអក្សរ |null ប្រភេទប្រធានបទសំខាន់។
topics អារេ \|null បញ្ជីចែកចាយប្រធានបទ។
anchor_lang អារេ \|null យុថ្កាការចែកចាយភាសាអត្ថបទ។
indexed_urls, referring_ips, referring_subnets ចំនួនគត់ |null សន្ទស្សន៍ និងបញ្ជរភាពចម្រុះនៃបណ្តាញ។

MozData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
moz_domain_authority ចំនួនគត់ |null Moz DA ។
moz_spam_score ចំនួនគត់ |null ពិន្ទុ Moz Spam ។
page_rank, moz_link_propensity លេខ|ចំនួនគត់ |null ចំណាត់ថ្នាក់កេរ្តិ៍ដំណែល និងតំណទំនោរ។
វាល moz_*_to_subdomain ចំនួនគត់ |null Moz តំណភ្ជាប់ក្រាហ្វ (ទំព័រ/ដែន តាមដាន/nofollow/ប្តូរទិស/លុប)។
moz_da_history_values ខ្សែអក្សរ |null តម្លៃប្រវត្តិសាស្រ្ត DA ស៊េរី។
backlinks MozBacklink[] \|null ជួរ Backlink (domain_source, url_source, domain_target, url_target, anchor_text, harmonic_centrality, last_found_date)។

KeywordseverywhereData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
etv ចំនួនគត់ |null តម្លៃចរាចរណ៍ប៉ាន់ស្មាន។
total_keywords ចំនួនគត់ |null ពាក្យគន្លឹះដែលបានតាមដានសរុប។
data ពាក្យគន្លឹះ[] \|null ជួរពាក្យគន្លឹះ (position, etv, keyword)។

SimilarWebData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
estimated_monthly_visits វត្ថុ |null ខែ → ទស្សនាផែនទី។
traffic_sources ប្រភពចរាចរណ៍ |null ឆានែលចែករំលែក៖ Social, Paid Referrals, Mail, Referrals, Search, Direct (សមាមាត្រ 0..1)។
top_country_shares ប្រទេសចែករំលែក[] \|null ការចែកចាយភូមិសាស្ត្រ (Country, CountryCode, Value) ។
engagments ពិធីភ្ជាប់ពាក្យ null`
category ខ្សែអក្សរ |null ប្រភេទគេហទំព័រស្រដៀងគ្នា។

BrandscoreData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
pronounceability, memorability, uniqueness, appeal, brandscore integer សមាសធាតុម៉ាកយីហោ និងពិន្ទុចុងក្រោយ។

KarmaMetricData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
karma_metric integer ពិន្ទុចុងក្រោយ 0..100 ។
components KarmaMetricComponents A_mass, A_cont, A_stab, A_trend (នីមួយៗ 0..100)។
period ខ្សែអក្សរ |null កំឡុងពេលក្នុងទម្រង់ YYYY-MM (ឬ null នៅពេលមិនមាន)។

TrustpilotData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
rating លេខ|null ការវាយតម្លៃជាធម្មតា 0..5 ។
reviews_count ចំនួនគត់ |null ចំនួននៃការពិនិត្យឡើងវិញ។
category ខ្សែអក្សរ |null ប្រភេទអាជីវកម្ម Trustpilot ។

GoogleData

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
google_index ធាតុ Google[] \|null ទំព័រលិបិក្រមសម្រាប់ site:domain (rank, url, title, description)។
google_mentions ធាតុ Google[] \|null រៀបរាប់លទ្ធផលសម្រាប់ការស្វែងរកដែនដែលបានដកស្រង់។

** CategoryData / BlacklistsData**

គំរូ វាលសំខាន់
CategoryData categories[], vendor, info_url
BlacklistsData vendor, info_url ជាជម្រើស info

web_archive (បន្ទុកម៉ាស៊ីន Wayback)

វត្ថុដែលមានប្លុកសំខាន់បី៖ info, ts_summary, history ។ នៅក្នុងការឆ្លើយតបរបាយការណ៍ពេញលេញ history ត្រូវបានបញ្ជូនមកវិញថ្មីបំផុតដំបូង។

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
info វត្ថុ |null ទុកឯកសារសង្ខេបការគ្របដណ្តប់សម្រាប់ដែន។
ts_summary វត្ថុ |null សញ្ញា KarmaScore / Wayback សរុបដែលប្រើក្នុងតម្រងតារាង។
history array ការកំណត់ពេលវេលារូបថត (វត្ថុមួយក្នុងមួយការចាប់យក Wayback) ។

web_archive.info

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
snap_counter integer ចំនួនសរុបនៃរូបថត Wayback ត្រូវបានរាប់។
years_counter integer ចំនួនឆ្នាំដែលមានសកម្មភាពក្នុងប័ណ្ណសារ (សញ្ញាអាយុដែន)។
first_ts integer ត្រាពេលវេលា Unix នៃរូបថតដំបូង។
last_ts integer ត្រាពេលវេលា Unix នៃរូបថតចុងក្រោយបំផុត។
years object ឆ្នាំ → ផែនទី​រាប់​រូបថត​ប្រចាំខែ (ទិន្នន័យ​បន្ទាត់​ភ្លើង/ប្រតិទិន)។

web_archive.ts_summary

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
average_karma_score integer ពិន្ទុ Karma ជាមធ្យម 0..100 (ផែនទីក្នុងបញ្ជីវាល karmascore)។
wa_changes integer ចំនួននៃការផ្លាស់ប្តូរខ្លឹមសារសំខាន់ៗនៅក្នុងប្រវត្តិដែលបានស្កេន។
wa_langs array ជួរចែកចាយភាសា៖ language, pageRatio (0..100)។
wa_server_code array ការចែកចាយកូដ HTTP៖ server_code (ឧ. 200, 301, 403), response_ratio (0..100)។
wa_tags array បានរកឃើញស្លាកមាតិកានៅលើប្រវត្តិ។
pattern_shares array លំនាំចែករំលែកជួរ៖ factor, description, share។
chart_data array ពិន្ទុស៊េរីពេលវេលា៖ timestamp, karma_score, lang, server_code, tags, detected_patterns ។

** web_archive.history[] (ជួររូបថត)**

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
snaped_at integer Snapshot Unix ត្រាពេលវេលា។
webarchive_link ខ្សែអក្សរ |null Wayback URL សម្រាប់ការចាប់យកនេះ (null នៅលើការបិទកន្លែងដាក់ខ្ទាស់)។
headers វត្ថុ |null ទិន្នន័យមេតា HTTP ជាទូទៅ status_code (200, 301, 302, 403, 404, 429, …), original_url។
screenshot ប៊ូលីន |null true ប្រសិនបើរូបថតអេក្រង់មាន (ប្រព័ន្ធគោលពីរត្រូវបានរក្សាទុកដោយឡែកពីគ្នា ទាញយកតាមរយៈរូបថតអេក្រង់ API នៅក្នុង UI)។
content_info វត្ថុ |null មាតិកាទំព័រដែលបានញែក (សូមមើលខាងក្រោម) ។
karma_score វត្ថុ |null ពិន្ទុក្នុងមួយរូបថត៖ score (0..100), detected_patterns, tags (រូបភាពអាសអាភាស/គ្រីបតូ/ល្បែង/…ទង់)។
redirects អារេ \|null បញ្ជូនបន្តទិន្នន័យខ្សែសង្វាក់នៅពេលមានវត្តមាន។
website_ids អារេ \|null លេខសម្គាល់គេហទំព័រដែលបានរកឃើញ (name, website, ids[]) ឧ. ស្លាកវិភាគ។
built_with វត្ថុ |null បច្ចេកវិជ្ជាផ្ទុកការរកឃើញជង់ (នៅពេលមាន)។

web_archive.history[].content_info

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
lang ខ្សែអក្សរ |null លេខកូដភាសាទំព័រដែលបានរកឃើញ។
title, description, keywords ខ្សែអក្សរ |null វាលអត្ថបទមេតា/ទំព័រដែលប្រើក្នុងតម្រង និង UI ។
generator, author, copyright ខ្សែអក្សរ |null វាលមេតាបន្ថែម។
h1 … h6 ខ្សែអក្សរ[] \|null ចំណងជើងអត្ថបទ (អាចស្វែងរកបានតាមរយៈតម្រង keywords)។
cloud_words អារេ \|null ធាតុពពកពាក្យ (word) ។
external_links, internal_links អារេ \|null បញ្ជីតំណចេញ/ចូល។
rel_canonical, meta_robots ខ្សែអក្សរ |null Canonical URL និងមេតារបស់មនុស្សយន្ត។
length_symbols, length_words integer ការរាប់ទំហំមាតិកា។

auctions (ឡូតិ៍ដេញថ្លៃ)

បង្ហាញនៅពេលដែលរបាយការណ៍មានទិន្នន័យដេញថ្លៃ (auctions ហើយជួនកាលជួរដែលពាក់ព័ន្ធនៅក្នុងមូលដ្ឋានផ្សេងទៀត)។ នៅក្នុង របាយការណ៍ពេញលេញ ការឆ្លើយតប ជាច្រើនត្រូវបានដាក់ជាក្រុមតាមពេលវេលាបញ្ចប់៖

{
  "1764441900": [
    { "source": "godaddy", "sale_type": "auction", "price": 120, "bids": 3, "...": "..." }
  ]
}
  • ** គ្រាប់ចុចវត្ថុ ** = end_time (យូនីកវិនាទី) ។
  • តម្លៃ = អារេនៃវត្ថុច្រើនដែលបញ្ចប់នៅពេលនោះ (វេទិកាច្រើនអាចចែករំលែកកូនសោមួយ)។
ប៉ារ៉ាម៉ែត្រ ប្រភេទ ការពិពណ៌នា
source string វេទិកាដេញថ្លៃ/ប្រភពចុះឈ្មោះ (ឧ. godaddy, namejet, dynadot, dropcatch, sedo, sav.com)។ មិនប្រកាន់អក្សរតូចធំនៅក្នុងតម្រង។
sale_type string ប្រភេទនៃការចុះបញ្ជី (ឧ. auction, buynow, Closeout, Pre-Release, Dropped)។
domain string ឈ្មោះដែនសម្រាប់ដីឡូតិ៍។
item_id string លេខសម្គាល់ឡូត៍/ការចុះបញ្ជីជាក់លាក់នៃវេទិកា។
end_time integer ពេលវេលាបញ្ចប់ Lot (Unix វិនាទី); ប្រើជាគន្លឹះដាក់ជាក្រុមនៅក្នុងរបាយការណ៍ពេញលេញផងដែរ។
price number តម្លៃបច្ចុប្បន្ន (ជាធម្មតា USD) ។
bids ចំនួនគត់ |null ចំនួនការដេញថ្លៃនៅពេលដែលអាចអនុវត្តបាន។
currency string និមិត្តសញ្ញា/លេខកូដរូបិយប័ណ្ណ (លំនាំដើម "$")។
report_type string មូលដ្ឋានកម្មសិទ្ធិ៖ auctions, backorder, ឬ buynow។
priority integer ការតម្រៀបខាងក្នុង/ទម្ងន់អាទិភាព (លំនាំដើម 0)។

គន្លឹះតម្រង៖ auction_source ក្នុងការស្វែងរកទទួលយកប្រភពធម្មតា (godaddy) ឬតម្លៃផ្សំ source|sale_type (ឧ. godaddy|auction)។

សម្រាប់ដែនកំណត់វាលពិតប្រាកដ (ច្បាប់ដែលមិនអាចរាប់បាន តម្លៃ enum អប្បបរមា/អតិបរមា វត្ថុដែលបានដាក់ជាប់គ្នា) តែងតែប្រើ OpenAPI ឬ ReDoc ។

report_type ប៉ារ៉ាម៉ែត្រ

សម្រាប់របាយការណ៍ពេញលេញ និងចំណូលចិត្ត៖ auctions, expired, backorder, buynow។ តម្លៃ all ត្រូវបានប្រើតែក្នុងតក្កវិជ្ជាស្វែងរក (មូលដ្ឋានទិន្នន័យទាំងអស់) មិនមែនជា {report_type} នៅក្នុងផ្លូវនោះទេ។

ការ​តម្រៀប​និង​តម្រៀប (បញ្ជី​ចំណុច​បញ្ចប់)

ប៉ារ៉ាម៉ែត្រសំណួរ៖

ប៉ារ៉ាម៉ែត្រ លំនាំដើម ការពិពណ៌នា
page 1 លេខទំព័រ
page_size 10 ទំហំទំព័រ (អតិបរមា 50)
sort_by added_at តម្រៀបឈ្មោះជួរឈរ (ដូចនៅក្នុងតារាង UI; enum នៅក្នុង OpenAPI)
sort_desc true true — ចុះ

ដែននៅក្នុង URLs

សម្រាប់ {domain} នៅក្នុងផ្លូវ ប្រើ percent-encoding (IDN, Cyrillic, etc.)។ ម៉ាស៊ីនមេធ្វើឱ្យឈ្មោះធម្មតា (សរសេរកូដ/អក្សរតូច)។

លំហូរការងារធម្មតា។

1. ស្វែងរក → របាយការណ៍ពេញលេញ

  1. POST https://api.karma.domains/v1/reports/search ជាមួយតួតម្រង (សូមមើល OpenAPI → ReportListFilterSchema)។
  2. ពី report_list[] យក report_id និង report_type ។
  3. GET https://api.karma.domains/v1/reports/{report_type}/{report_id}។

តម្រងត្រូវគ្នា filters in the web UI — ងាយស្រួលក្នុងការប្រៀបធៀបជាមួយ UI ។ សូមមើល OpenAPI សម្រាប់គ្រោងការណ៍វាល។

2. ដែនពិតប្រាកដដោយគ្មានការស្វែងរកយូរ

  1. GET /v1/reports/by-domain/example.com
  2. នៅក្នុងការឆ្លើយតប matches[] — រហូតដល់មួយធាតុក្នុងមួយមូលដ្ឋានទិន្នន័យដែលដែនមាន។
  3. ជ្រើសរើស report_type → GET /v1/reports/{report_type}/{report_id} ដែលត្រូវការ។

ប្រសិនបើ matches ទទេ — ដែនមិនស្ថិតនៅក្នុងមូលដ្ឋានទិន្នន័យ Karma ទេ។

3. ចំណូលចិត្ត

  • បញ្ជីតែប៉ុណ្ណោះ៖ GET /v1/reports/favorites
  • បញ្ជីដូចគ្នាតាមរយៈការស្វែងរក៖ POST /v1/reports/search ជាមួយ "favorites": true នៅក្នុងតួ
  • បន្ថែម៖ POST /v1/reports/favorites ជាមួយ {"report_id": "...", "report_type": "expired"}
  • ដកចេញ៖ DELETE /v1/reports/favorites/expired/{report_id}

4. ទម្លាក់ការត្រួតពិនិត្យ (របាយការណ៍ផុតកំណត់)

GET /v1/reports/check/expired/{report_id} — ** លេខសម្គាល់របាយការណ៍ ** មិនមែនឈ្មោះដែនទេ។

  • នៅពេលពិនិត្យជោគជ័យ ធ្វើបច្ចុប្បន្នភាពកំណត់ត្រារបាយការណ៍នៅលើម៉ាស៊ីនមេ
  • is_expired: true — ដែន ទំនង​ជា​អាច​ប្រើ​បាន ដើម្បី​ចុះ​ឈ្មោះ (មិន​មែន “កាលបរិច្ឆេទ​ផុត​កំណត់​របស់ WHOIS បាន​ឆ្លង​ផុត​ទេ”)
  • ធ្វើម្តងទៀត បន្តផ្ទាល់ ពិនិត្យមើលរបាយការណ៍ដូចគ្នា — យ៉ាងច្រើនបំផុត ម្តងរៀងរាល់ 3 ម៉ោង (ច្បាប់អាជីវកម្ម)
  • ការឆ្លើយតប HTTP ត្រូវបានទុកក្នុងឃ្លាំងសម្ងាត់ 1 ម៉ោង សម្រាប់ GET ដដែលៗ report_id (សូមមើល “Caching”)

5. ពិនិត្យដែនដោយគ្មានរបាយការណ៍នៅក្នុងមូលដ្ឋានទិន្នន័យ

GET /v1/domains/checker/expiry/{domain} — បន្តផ្ទាល់ WHOIS/DNS; មិនផ្លាស់ប្តូររបាយការណ៍មូលដ្ឋានទិន្នន័យទេ។

  • available: true — ទំនងជាអាចចុះឈ្មោះបាន។
  • available: false — បាន​យក​ឬ​បម្រុង​ទុក
  • ស្នើសុំម្តងទៀតសម្រាប់ដែនដូចគ្នាក្នុងរយៈពេល ~1 ម៉ោង អាចត្រឡប់ការឆ្លើយតបដែលបានរក្សាទុកក្នុងឃ្លាំងសម្ងាត់

6. Karma Metric លឿន

GET /v1/domains/checker/karma_metric/{domain} — Karma Metric ពីម៉ាស៊ីន WayBack; មិនធ្វើបច្ចុប្បន្នភាពរបាយការណ៍។ វាលឆ្លើយតប — OpenAPI (KarmaMetricData) ។ ឃ្លាំងសម្ងាត់ឆ្លើយតបក្នុងមួយដែន — ~1 ម៉ោង។

អានបន្ថែមអំពី Karma Metric in the blog

7. តុល្យភាពនិងផែនការ

GET /v1/user — អ៊ីមែល balance (ឥណទាន) ទង់ផែនការ ទិន្នន័យការជាវ។ សោ API មិននៅក្នុងការឆ្លើយតបទេ។ ការឆ្លើយតបត្រូវបានទុកក្នុងឃ្លាំងសម្ងាត់ ~1 នាទី ក្នុងមួយសោ — កុំស្ទង់មតិញឹកញាប់ជាងតម្រូវការសម្រាប់សមតុល្យទាន់សម័យ។

ឃ្លាំងសម្ងាត់

នៅកម្រិត Public API, តួឆ្លើយតប HTTP ត្រូវបានទុកក្នុងឃ្លាំងសម្ងាត់។ ចំណុចបញ្ចប់មួយចំនួនប្រើ ការធ្វើឱ្យស្រស់ដំបូង (ធ្វើឱ្យផ្ទៃខាងក្រោយស្រស់មុនពេល TTL ផុតកំណត់: 4 នាទីសម្រាប់ 5 នាទី TTL, 50 នាទីសម្រាប់ 1 ម៉ោង TTL) ។

ចំណុចបញ្ចប់ TTL
POST /v1/reports/search 5 នាទី
GET /v1/reports/favorites 5 នាទី
POST /v1/reports/favorites គ្មាន
DELETE /v1/reports/favorites/{report_type}/{report_id} គ្មាន
GET /v1/reports/by-domain/{domain} 5 នាទី
GET /v1/reports/check/expired/{report_id} 1 ម៉ោង។
GET /v1/reports/{report_type}/{report_id} គ្មាន
GET /v1/user 1 នាទី
GET /v1/domains/checker/expiry/{domain} 1 ម៉ោង។
GET /v1/domains/checker/karma_metric/{domain} 1 ម៉ោង។

ចំណូលចិត្ត POST/DELETE ប្តូរទិន្នន័យម៉ាស៊ីនមេភ្លាមៗ ប៉ុន្តែការធ្វើម្តងទៀត GET /favorites ឬ POST /search ជាមួយ favorites: true អាចត្រឡប់បញ្ជីចាស់រហូតដល់ឃ្លាំងសម្ងាត់ផុតកំណត់ (5 នាទី)។

ស្នើសុំឧទាហរណ៍ (អង្កាញ់)

ជំនួស YOUR_API_KEY ដោយសោទម្រង់របស់អ្នក។ URL មូលដ្ឋាន៖ https://api.karma.domains។

ការស្វែងរកបានផុតកំណត់ជាមួយនឹងតម្រងមួយ។

curl -X POST "https://api.karma.domains/v1/reports/search?page=1&page_size=25&sort_by=added_at&sort_desc=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "karmascore_min": 60,
    "domain_type": ["expired"]
  }'

តម្រងតួ — វាលណាមួយពី ReportListFilterSchema ក្នុង OpenAPI ។

របាយការណ៍ពេញលេញ

curl "https://api.karma.domains/v1/reports/expired/507f1f77bcf86cd799439011" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

ស្វែងរកតាមដែន

curl "https://api.karma.domains/v1/reports/by-domain/example.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

បន្ថែមទៅចំណូលចិត្ត

curl -X POST "https://api.karma.domains/v1/reports/favorites" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "report_id": "507f1f77bcf86cd799439011",
    "report_type": "expired"
  }'

ការត្រួតពិនិត្យភាពអាចរកបាននៃដែន

curl "https://api.karma.domains/v1/domains/checker/expiry/mybrand.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Karma Metric

curl "https://api.karma.domains/v1/domains/checker/karma_metric/mybrand.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

ករណីប្រើប្រាស់រួមបញ្ចូលគ្នា

បំពង់ជ្រើសរើសដែលផុតកំណត់ពេលយប់

cron ប្រចាំថ្ងៃ៖ POST /search ជាមួយនឹងតម្រង JSON ដែលបានរក្សាទុក (ដូចជា saved filter នៅក្នុង UI) ការភ្ជាប់ទំព័រជាមួយ page_size=50 នាំចេញ report_id ទៅ DB របស់អ្នក។ ការវិភាគលម្អិត — GET របាយការណ៍ពេញលេញសម្រាប់តែបញ្ជីសម្រាំងប៉ុណ្ណោះ។

ត្រួតពិនិត្យបញ្ជីឈ្មោះមុនពេលចុះឈ្មោះ

ជួរនៃដែន → GET /domains/checker/expiry/{domain} → សាខានៅលើ available ។ មិនតម្រូវឱ្យមានរបាយការណ៍នៅក្នុង Karma.Domains ទេ។

ធ្វើសមកាលកម្មចំណូលចិត្តជាមួយ CRM ខាងក្នុង

តាមកាលកំណត់ GET /favorites; នៅលើសកម្មភាពរបស់អ្នកប្រើនៅក្នុង CRM — POST/DELETE សំណព្វ។ គណនីសម្រាប់ឃ្លាំងសម្ងាត់បញ្ជី ~ 5 នាទី។

ការវិភាគ BI / funnel

នាំចេញទំព័រស្វែងរក សរុប total_count និងម៉ែត្រពី report_list ដោយមិនចាំបាច់បើក UI ។ បញ្ជីគ្រោងការណ៍ជួរ — ReportListResponseSchema ក្នុង OpenAPI ។

MCP + ស្គ្រីបនៅលើសោមួយ។

ក្រុមប្រើ MCP ក្នុងទស្សន៍ទ្រនិចសម្រាប់ការស្វែងរកតាមតែចិត្ត និង API សាធារណៈសម្រាប់ ETL ដែលមានស្ថេរភាព។ សរុប ** 60 សំណើក្នុងមួយនាទី** — ផែនការជាបាច់ និងត្រឡប់មកវិញនៅលើ 429 ។

MCP និង API សាធារណៈ

API សាធារណៈ (REST) MCP
ទស្សនិកជន អ្នកអភិវឌ្ឍន៍ ស្គ្រីប ETL ជំនួយការ AI (ទស្សន៍ទ្រនិច ក្លូដ)
ចំណុចប្រទាក់ HTTP + JSON ប្រអប់, ឧបករណ៍
ឯកសារ ទំព័រនេះ + OpenAPI /km/expired-domains-mcp/
ទិន្នន័យ របាយការណ៍ និងមូលដ្ឋានទិន្នន័យដូចគ្នា។ ដូចគ្នា
សោ & ដែនកំណត់ បានចែករំលែក បានចែករំលែក

សម្រាប់ការរួមបញ្ចូលកូដថ្មី សូមចាប់ផ្តើមជាមួយ REST។ សម្រាប់ការពិសោធន៍ជជែក — MCP ។

សំណួរគេសួរញឹកញាប់

តើសេចក្តីយោងវាលតម្រងពេញលេញនៅឯណា?

OpenAPI, គ្រោងការណ៍ ** ReportListFilterSchema** ។ អត្ថន័យវាលត្រូវគ្នានឹង filter help នៅក្នុង UI ។

តើអ្វីជាភាពខុសគ្នារវាង available និង is_expired?

ទាំងពីរនៅក្នុងបរិបទ API មានន័យថា៖ ដែនគឺ ទំនងជាអាចចុះឈ្មោះបាន។ available — ពិនិត្យផ្ទាល់តាមឈ្មោះ (/domains/checker/expiry)។ is_expired — ធីក​ភ្ជាប់​ទៅ​នឹង​របាយការណ៍​មូលដ្ឋាន​ទិន្នន័យ​ដែល​ផុត​កំណត់ (/reports/check/expired/{report_id})។

ហេតុអ្វីបានជា 403 ជាមួយនឹងសោត្រឹមត្រូវ?

មិនមានគម្រោង Pro សកម្មទេ។ ពិនិត្យមើលការជាវនៅក្នុងប្រវត្តិរូប។

ហេតុអ្វីបានជាការឆ្លើយតប API មិនត្រូវគ្នានឹង UI ឬសកម្មភាពដែលទើបតែធ្វើ?

ឃ្លាំងសម្ងាត់ API HTTP សាធារណៈ — សូមមើលតារាងក្នុង “ឃ្លាំងសម្ងាត់”។ គណនីសម្រាប់ TTL នៅពេលធ្វើសមកាលកម្មជាមួយ UI ។

តើតម្លៃ sort_by អ្វីខ្លះត្រូវបានអនុញ្ញាត?

បញ្ជី Enum នៅក្នុង OpenAPI — ឈ្មោះនៃជួរឈរតារាងរបាយការណ៍នៅក្នុងកម្មវិធីបណ្តាញ។

តើខ្ញុំត្រូវការទំព័រនេះទេប្រសិនបើ OpenAPI មាន?

OpenAPI គឺជាប្រភពនៃការពិតសម្រាប់ប្រភេទ និងវាល។ ទំព័រនេះបន្ថែមបរិបទ៖ ដែនកំណត់ ឃ្លាំងសម្ងាត់ ការបញ្ជាទិញការហៅទូរសព្ទ ករណីប្រើប្រាស់ និងបញ្ហាដែលមិនមាននៅក្នុងគ្រោងការណ៍។

តើមានប្រអប់ខ្សាច់ទេ?

គ្មានប្រអប់ខ្សាច់ដាច់ដោយឡែក; ប្រើគណនី Pro និងគោរពកម្រិតអត្រាការប្រាក់។ សម្រាប់ការកែកំហុស GET /user និងតូចចង្អៀត POST /search ជាមួយនឹងតម្រងដ៏តឹងរឹងដំណើរការល្អ។

លេខកូដកំហុស

កូដ អត្ថន័យ
២០០ ជោគជ័យ
៤០១ គ្មានការអនុញ្ញាត (សោ)
៤០៣ គ្មានប្រូ
៤០៤ រកមិនឃើញរបាយការណ៍ ឬធនធានទេ។
422 កំហុសក្នុងការផ្ទៀងផ្ទាត់តួ/សំណួរ (តម្រងមិនត្រឹមត្រូវ, sort_by, …)
429 លើសដែនកំណត់អត្រា
503 ការកំណត់អត្រាការប្រាក់មិនមានជាបណ្តោះអាសន្នទេ។

តួនៃកំហុសជាធម្មតាមាន detail (ខ្សែអក្សរ ឬអារេវត្ថុដែលមានសុពលភាព)។ ឧទាហរណ៍៖

{
  "detail": "Invalid API key"
}

តំណភ្ជាប់មានប្រយោជន៍

សាកល្បងឥតគិតថ្លៃ!

ប្រើប្រាក់កម្ចីប្រាក់រង្វាន់!

បើកបញ្ជីដែន
+5