域名定价 API 参考 | DomScan 产品

Q: 在哪里可以找到 域名定价 的请求和响应参考？

使用 域名定价 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

获取多个注册商中域名的注册和续费价格。

同步批量RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

单一决策使用专用检查，需要上下文时再构建更完整的资料。

适合选择此产品的场景

存在覆盖时，需要比较公开的注册、续期或转移价格证据时选择。

你将获得什么

获取多个注册商中域名的注册和续费价格。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/prices 查看 API 参考

POST /v1/prices/bulk 查看 API 参考

GET /v1/prices/tld/:tld 查看 API 参考

GET /v1/prices/registrars 查看 API 参考

GET /v1/prices/compare 查看 API 参考

GET /v1/pricing 查看 API 参考

积分和身份验证

0-1 需要身份验证。有关确切费用和按项计费，请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/prices

查询参数

参数	类型	必需
tlds	string	可选
registrars	string	可选
skip_cache	boolean 默认值 `false`	可选

响应字段

字段	类型
`success`	boolean
`data`	object
`data.supportedTlds[]`	string[]
`data.count`	integer
`data.hint`	string
`data.results[]`	object[]
`data.results[]`	object
`data.results[].tld`	string
`data.results[].prices[]`	object[]
`data.results[].prices[]`	object
`data.results[].prices[].registrar`	string
`data.results[].prices[].registrarName`	string
`data.results[].prices[].register`	number \| null
`data.results[].prices[].renew`	number \| null
`data.results[].prices[].transfer`	number \| null
`data.results[].prices[].currency`	string
`data.results[].prices[].promoPrice`	number \| null
`data.results[].prices[].promoDetails`	string \| null
`data.results[].prices[].features`	object
`data.results[].prices[].features.freeWhoisPrivacy`	boolean
`data.results[].prices[].features.freeDns`	boolean
`data.results[].prices[].lastUpdated`	string \| null
`data.results[].prices[].source`	string
`data.results[].prices[].sourceName`	string
`data.results[].prices[].sourceUrl`	string \| null
`data.results[].prices[].confidence`	string
`data.results[].prices[].sourceType`	string
`data.results[].prices[].quoteScope`	string
`data.results[].prices[].observedAt`	string \| null
`data.results[].prices[].recommendationEligible`	boolean
`data.results[].prices[].recommendationExclusionReason`	string \| null
`data.results[].cheapest`	object
`data.results[].cheapest.register`	object \| null
`data.results[].cheapest.renew`	object \| null
`data.results[].cheapest.transfer`	object \| null
`data.results[].averagePrice`	object
`data.results[].averagePrice.register`	number \| null
`data.results[].averagePrice.renew`	number \| null
`data.results[].averagePrice.transfer`	number \| null
`data.results[].priceRange`	object
`data.results[].priceRange.register`	object \| null
`data.results[].priceRange.renew`	object \| null
`data.results[].priceRange.transfer`	object \| null
`data.results[].lastUpdated`	string \| null
`data.results[].dataQuality`	object
`data.results[].dataQuality.sourcesQueried`	integer
`data.results[].dataQuality.sourcesSucceeded`	integer
`data.results[].dataQuality.cacheHitRate`	number
`data.results[].dataQuality.averageConfidence`	string
`data.results[].price_summary`	object
`data.results[].price_summary.registrar_count`	integer
`data.results[].price_summary.registrar_coverage_ratio`	number
`data.results[].price_summary.price_points`	object
`data.results[].price_summary.price_points.register`	integer
`data.results[].price_summary.price_points.renew`	integer
`data.results[].price_summary.price_points.transfer`	integer
`data.results[].price_summary.source_counts`	object
`data.results[].price_summary.confidence_counts`	object
`data.results[].price_summary.freshness`	object
`data.results[].price_summary.freshness.freshest_at`	string \| null
`data.results[].price_summary.freshness.oldest_at`	string \| null
`data.results[].price_summary.freshness.newest_age_hours`	number \| null
`data.results[].price_summary.freshness.stale_price_count`	integer
`data.results[].price_summary.freshness.unknown_freshness_count`	integer
`data.results[].price_summary.spread`	object
`data.results[].price_summary.spread.register_usd`	number \| null
`data.results[].price_summary.spread.renew_usd`	number \| null
`data.results[].price_summary.spread.transfer_usd`	number \| null
`data.results[].price_summary.outlier_count`	integer
`data.results[].price_summary.recommendation_eligible_registrar_count`	integer
`data.results[].price_summary.quality_status`	string
`data.results[].price_summary.cheapest_register`	object \| null
`data.results[].price_summary.cheapest_renew`	object \| null
`data.results[].price_summary.cheapest_transfer`	object \| null
`data.results[].checkAccounting`	object
`data.results[].checkAccounting.plannedChecks`	integer
`data.results[].checkAccounting.actualChecks`	integer
`data.results[].checkAccounting.successfulRows`	integer
`data.results[].checkAccounting.creditsCharged`	integer
`data.results[].checkAccounting.creditsPerCheck`	integer
`data.results[].checkAccounting.selectedRegistrars[]`	string[]
`data.summary`	object
`data.summary.tldsRequested`	integer
`data.summary.tldsWithData`	integer
`data.summary.totalPricePoints`	integer
`data.summary.quoteCount`	integer
`data.summary.numericPriceFieldCount`	integer
`data.summary.market_summary`	object
`data.summary.market_summary.tlds_requested`	integer
`data.summary.market_summary.tlds_with_data`	integer
`data.summary.market_summary.quote_count`	integer
`data.summary.market_summary.integrated_source_count`	integer
`data.summary.market_summary.total_price_points`	integer
`data.summary.market_summary.average_registrar_coverage_ratio`	number
`data.summary.market_summary.stale_tld_count`	integer
`data.summary.market_summary.fallback_tld_count`	integer
`data.summary.market_summary.outlier_tld_count`	integer
`data.summary.market_summary.widest_register_spread_tld`	string \| null
`data.summary.market_summary.max_register_spread_usd`	number \| null
`data.summary.market_summary.freshest_price_at`	string \| null
`data.summary.market_summary.oldest_price_at`	string \| null
`data.summary.market_summary.checkAccounting`	object
`data.summary.market_summary.checkAccounting.plannedChecks`	integer
`data.summary.market_summary.checkAccounting.actualChecks`	integer
`data.summary.market_summary.checkAccounting.successfulRows`	integer
`data.summary.market_summary.checkAccounting.creditsCharged`	integer
`data.summary.market_summary.checkAccounting.creditsPerCheck`	integer
`data.summary.market_summary.checkAccounting.selectedRegistrars[]`	string[]
`data.summary.checkAccounting`	object
`data.summary.checkAccounting.plannedChecks`	integer
`data.summary.checkAccounting.actualChecks`	integer
`data.summary.checkAccounting.successfulRows`	integer
`data.summary.checkAccounting.creditsCharged`	integer
`data.summary.checkAccounting.creditsPerCheck`	integer
`data.summary.checkAccounting.selectedRegistrars[]`	string[]
`meta`	object
`meta.requestId`	string
`meta.servedBy`	string
`meta.durationMs`	integer
`meta.cacheStatus`	string

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/prices?tlds=com%2Cnet%2Corg&registrars=porkbun%2Cdynadot&skip_cache=false"

响应示例

{
  "success": true,
  "data": {
    "supportedTlds": [
      "com"
    ],
    "count": 1,
    "hint": "example",
    "results": [
      {
        "tld": "com",
        "prices": [
          {
            "registrar": "example",
            "registrarName": "example",
            "register": 0.5,
            "renew": 0.5,
            "transfer": 0.5,
            "currency": "USD",
            "promoPrice": 0.5,
            "promoDetails": "example",
            "features": {
              "freeWhoisPrivacy": false,
              "freeDns": false
            },
            "lastUpdated": "2026-08-27T12:00:00Z",
            "source": "api",
            "sourceName": "example",
            "sourceUrl": "https://example.com",
            "confidence": "high",
            "sourceType": "official_api",
            "quoteScope": "tld_standard",
            "observedAt": "2026-08-27T12:00:00Z",
            "recommendationEligible": false,
            "recommendationExclusionReason": "stale"
          }
        ],
        "cheapest": {
          "register": {},
          "renew": {},
          "transfer": {}
        },
        "averagePrice": {
          "register": 0.5,
          "renew": 0.5,
          "transfer": 0.5
        },
        "priceRange": {
          "register": {},
          "renew": {},
          "transfer": {}
        },
        "lastUpdated": "2026-08-27T12:00:00Z",
        "dataQuality": {
          "sourcesQueried": 1,
          "sourcesSucceeded": 1,
          "cacheHitRate": 0.5,
          "averageConfidence": "high"
        },
        "price_summary": {
          "registrar_count": 1,
          "registrar_coverage_ratio": 0.5,
          "price_points": {
            "register": 1,
            "renew": 1,
            "transfer": 1
          },
          "source_counts": {},
          "confidence_counts": {},
          "freshness": {
            "freshest_at": "2026-08-27T12:00:00Z",
            "oldest_at": "2026-08-27T12:00:00Z",
            "newest_age_hours": 0.5,
            "stale_price_count": 1,
            "unknown_freshness_count": 1
          },
          "spread": {
            "register_usd": 0.5,
            "renew_usd": 0.5,
            "transfer_usd": 0.5
          },
          "outlier_count": 1,
          "recommendation_eligible_registrar_count": 1,
          "quality_status": "healthy",
          "cheapest_register": {},
          "cheapest_renew": {},
          "cheapest_transfer": {}
        },
        "checkAccounting": {
          "plannedChecks": 1,
          "actualChecks": 1,
          "successfulRows": 1,
          "creditsCharged": 1,
          "creditsPerCheck": 1,
          "selectedRegistrars": [
            "example"
          ]
        }
      }
    ],
    "summary": {
      "tldsRequested": 1,
      "tldsWithData": 1,
      "totalPricePoints": 1,
      "quoteCount": 1,
      "numericPriceFieldCount": 1,
      "market_summary": {
        "tlds_requested": 1,
        "tlds_with_data": 1,
        "quote_count": 1,
        "integrated_source_count": 1,
        "total_price_points": 1,
        "average_registrar_coverage_ratio": 0.5,
        "stale_tld_count": 1,
        "fallback_tld_count": 1,
        "outlier_tld_count": 1,
        "widest_register_spread_tld": "com",
        "max_register_spread_usd": 0.5,
        "freshest_price_at": "2026-08-27T12:00:00Z",
        "oldest_price_at": "2026-08-27T12:00:00Z",
        "checkAccounting": {
          "plannedChecks": 1,
          "actualChecks": 1,
          "successfulRows": 1,
          "creditsCharged": 1,
          "creditsPerCheck": 1,
          "selectedRegistrars": [
            "example"
          ]
        }
      },
      "checkAccounting": {
        "plannedChecks": 1,
        "actualChecks": 1,
        "successfulRows": 1,
        "creditsCharged": 1,
        "creditsPerCheck": 1,
        "selectedRegistrars": [
          "example"
        ]
      }
    }
  },
  "meta": {
    "requestId": "request-id",
    "servedBy": "example",
    "durationMs": 1,
    "cacheStatus": "hit"
  }
}