99.99%
可用性
面向生产的端点按 99.99% 可用性和已记录的状态处理方式设计。
分类
社交
API 端点
2
主要功能
5
常见问题解答
1
被出色公司的人们使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
handleplatforms
响应示例
handleavailabilityavailability.pinterestavailability.pinterest.availableavailability.pinterest.profile_urlavailability.pinterest.checkedavailability.pinterest.requestedavailability.pinterest.methodavailability.pinterest.confidenceavailability.pinterest.latency_msavailability.pinterest.evidencesummary
HTTP 状态码
200400401402429500502503504
API 端点
GET
/v1/social
handleplatforms
GET
/v1/social/info
社交句柄可用性
PI
Pinterest
pinterest
2-30个字符，仅限字母数字、下划线和句点
GET /v1/social?handle=mybrand&platforms=pinterest
https://www.pinterest.com/mybrand/
status=live method=public_profile confidence=medium
API
API 接口
26 API 端点
检查受支持社交媒体平台上的用户名可用性。
GET /v1/social?handle=mybrand
GET /v1/social/info
KEY
身份验证
积分
使用 Authorization 头在请求中包含您的 API 密钥：
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
GH
GitHub
github
1-39个字符，仅限字母数字和连字符，不能以连字符开头或结尾
GET /v1/social?handle=mybrand&platforms=github
GL
GitLab
gitlab
1-255个字符，可使用字母、数字、下划线、连字符和句点；不能以连字符开头，也不能以句点、.git 或 .atom 结尾
GET /v1/social?handle=mybrand&platforms=gitlab
BB
Bitbucket
bitbucket, bb
1-255个字符，可使用字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=bitbucket
DT
Dev.to
devto, dev.to
2-30个字符，可使用字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=devto
HF
Hugging Face
huggingface, hf
1-39个字符，仅限字母数字和连字符，不能以连字符开头或结尾
GET /v1/social?handle=mybrand&platforms=huggingface
DB
Dribbble
dribbble
1-40个字符，仅限字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=dribbble
SD
SoundCloud
soundcloud
1-40个字符，仅限字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=soundcloud
GR
Gumroad
gumroad
1-63个字符，字母、数字和连字符；不能以连字符开头或结尾
GET /v1/social?handle=mybrand&platforms=gumroad
BMC
Buy Me a Coffee
buymeacoffee, bmc
1-40个字符，仅限字母和数字
GET /v1/social?handle=mybrand&platforms=buymeacoffee
SB
Substack
substack
1-63个字符，仅限字母和数字
GET /v1/social?handle=mybrand&platforms=substack
IT
itch.io
itchio, itch.io
1-30个字符，字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=itchio
HN
Hacker News
hackernews, hn
1-20个字符，可使用字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=hackernews
RE
Reddit
reddit
3-20个字符，仅限字母数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=reddit
BL
Bluesky
bluesky, bsky
3-253个字符，域名风格的用户名，仅限字母、数字、连字符和句点
GET /v1/social?handle=mybrand&platforms=bluesky
X
X / Twitter
x, twitter
1-15个字符，仅限字母数字和下划线
GET /v1/social?handle=mybrand&platforms=twitter
IN
Instagram
instagram, ig
1-30个字符，仅限字母数字、下划线和句点
GET /v1/social?handle=mybrand&platforms=instagram
FA
Facebook
facebook, fb
4-50个字符，仅限字母数字和句点
GET /v1/social?handle=mybrand&platforms=facebook
TH
Threads
threads
1-30个字符，仅限字母数字、下划线和句点
GET /v1/social?handle=mybrand&platforms=threads
SC
Snapchat
snapchat, snap
3-15个字符，必须以字母开头，可使用拉丁字母、数字、连字符、下划线和句点，且必须以字母或数字结尾
GET /v1/social?handle=mybrand&platforms=snapchat
TE
Telegram
telegram, tg
3-32个字符，必须以字母开头，仅限字母、数字和单个下划线，末尾不能是下划线
GET /v1/social?handle=mybrand&platforms=telegram
TW
Twitch
twitch
3-25个字符，仅限字母数字和下划线
GET /v1/social?handle=mybrand&platforms=twitch
PT
Patreon
patreon
1-100个字符，仅限字母、数字、下划线和连字符
GET /v1/social?handle=mybrand&platforms=patreon
TI
TikTok
tiktok
2-24个字符，仅限字母数字、下划线和句点
GET /v1/social?handle=mybrand&platforms=tiktok
YT
YouTube
youtube, yt
3-30个字符，仅限字母数字、下划线、句点和连字符
GET /v1/social?handle=mybrand&platforms=youtube
IN
LinkedIn
linkedin
3-100个字符，仅限字母数字和连字符
GET /v1/social?handle=mybrand&platforms=linkedin
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
可用性
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
即时结果
在几秒钟内获得所有平台的可用性状态。
个人资料链接
已占用处理的现有个人资料的直接链接。
摘要统计
可用与已占用平台的快速概览。
API访问
集成到您的品牌研究工作流中。
与域名结合
检查社交处理以及域名可用性。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=mybrand&platforms=pinterest"响应示例
{
"handle": "mybrand",
"availability": {
"pinterest": {
"available": false,
"profile_url": "https://www.pinterest.com/mybrand/",
"checked": true,
"requested": true,
"method": "public_profile",
"confidence": "medium",
"latency_ms": 104,
"evidence": { "source": "upstream" }
}
},
"summary": {
"available_count": 0,
"unavailable_count": 1,
"unknown_count": 0
},
"summary_v2": {
"requested_count": 1,
"checked_count": 1,
"available_count": 0,
"unavailable_count": 1,
"unknown_count": 0,
"not_supported_count": 0,
"determinacy_rate": 1
}
}常见问题解答
为什么我应该检查社交处理可用性?
品牌一致性很重要。如果您的公司叫"acme",理想情况下您希望acme.com、社交平台上的@acme和GitHub上的/acme。提前检查可以帮助您在需要时调整。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制
服务器错误
500
内部错误
网关错误
502
上游 RDAP 错误
服务不可用
503
上游服务不可用或正在临时限流。
网关超时
504
上游查询已超时。
每月 10,000 免费积分起步。几秒内开始检查域名。