api

نفس JSON الموقع

REST وJSON ومفاتيح Bearer. أنشئ مفتاحًا في حسابك، ثم استدعِ أي نقطة نهاية أدناه. المواصفة المقروءة آليًا في /api/v1/openapi.json (OpenAPI 3.1).

الحصص حسب الخطة
الخطةاستدعاءات API / شهرالأرصدة / شهرحد القائمةنقاط النهاية
تجربة30050100 / قائمةappraise, usage, bulk, drops
Starter1,000300500 / قائمةappraise, usage, bulk, drops

تدفع الأرصدة ثمن عمل المحرك، رصيد لكل تقييم ورصيد لكل نطاق في القائمة. حصة API تَعُدّ الطلبات. يُصفَّر الاثنان شهريًا.

البداية السريعة
تقييم نطاقbash
curl -X POST https://resaleodds.com/api/v1/appraise \
  -H "Authorization: Bearer dsk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "creditseason.com"}'
إرسال قائمة (Pro وما فوق)bash
curl -X POST https://resaleodds.com/api/v1/bulk \
  -H "Authorization: Bearer dsk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["a.com", "b.com", "c.com"]}'
الاطلاع على استهلاكك (مجانًا)bash
curl https://resaleodds.com/api/v1/usage \
  -H "Authorization: Bearer dsk_YOUR_KEY"
خادم mcp
https://resaleodds.com/api/mcpStreamable HTTP
claude mcp add --transport http domainvalue https://resaleodds.com/api/mcp \
  --header "Authorization: Bearer dsk_YOUR_KEY"

الأدوات appraise_domain وlist_drops وget_usage، بنفس حصص نقاط نهاية REST. التفاصيل والعملاء الآخرون في صفحة الوكلاء.

نقاط النهاية
  • post/api/v1/appraise

    Appraise a single domain

    Costs 1 API call + 1 credit. Cached results (24h, same calibration) are free.

  • post/api/v1/bulk

    Submit a bulk appraisal job

    Pro plan and above. 1 API call + 1 credit per domain. Results ranked by opportunity (value × probability of sale).

  • get/api/v1/bulk/{id}

    Poll a bulk job

  • get/api/v1/drops

    Daily curated expired domains

    Pro plan and above. Safe-zone filtered, opportunity-ranked. Source is a deterministic mock until CZDS zone-file access is granted (clearly labeled).

  • get/api/v1/demand/{domain}

    Solvent demand: buyer candidates and upgrade-domain targets

    Business plan. Who could buy this name (with budget bands) and which degraded variants (hyphenated, other TLDs, prefixed) host active sites — the documented upgrade-buyer profile. Candidates are flagged `simulated: true` until live company search is enabled.

  • get/api/v1/usage

    Current API usage and quota

    Free of charge (cost 0).

الأخطاء وترويسات الحصص

الأخطاء دائمًا بالشكل {"error": {"code", "message"}} مع رموز حالة HTTP واضحة: 401 المفتاح، 402 الأرصدة، 403 الخطة، 422 المدخلات، 429 الحصة. تحمل كل استجابة مصرَّح بها X-RateLimit-Limit / Used / Remaining / Month.