itch.io 用户名检查器 API 接口

分类 身份与验证

API 端点 3

主要功能 5

常见问题解答 2

被出色公司的人们使用

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

实时服务状态

集成前，请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

一次认证

使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。

用示例查询

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

OpenAPI 架构

生成客户端，或检查每种请求和响应结构。

Postman 集合

导入现成请求，用于手动测试和团队交接。

SDK 和 CLI

使用维护中的包和命令行流程，避免编写样板代码。

MCP 集成

把域名情报暴露给 AI 代理和内部助手工作流。

参数和响应映射

在把端点接入客户端前，快速查看输入、输出字段和状态码。

请求参数

参数

handleplatformshandles

响应字段

响应示例

handleavailabilityavailability.itchioavailability.itchio.availableavailability.itchio.profile_urlavailability.itchio.checkedavailability.itchio.requestedavailability.itchio.methodavailability.itchio.confidenceavailability.itchio.latency_msavailability.itchio.evidencesummary

状态覆盖

HTTP 状态码

200400401402429

API 端点

GET /v1/social

积分: 2身份验证: 需要身份验证

handleplatforms

POST /v1/social/bulk

积分: 2/item身份验证: 需要身份验证

handlesplatforms

GET /v1/social/info

积分: 0身份验证: 需要身份验证

社交句柄可用性

itch.io

itchio, itch.io

1-30个字符，字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=itchio https://mybrand.itch.io/ status=live method=public_profile confidence=high

API

API 接口

35 API 端点

检查受支持社交媒体平台上的用户名可用性。

GET /v1/social?handle=mybrand GET /v1/social/info

KEY

身份验证

积分

使用 Authorization 头在请求中包含您的 API 密钥：

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

GitHub

github

1-39个字符，仅限字母数字和连字符，不能以连字符开头或结尾

GET /v1/social?handle=mybrand&platforms=github

GitLab

gitlab

1-255个字符，可使用字母、数字、下划线、连字符和句点；不能以连字符开头，也不能以句点、.git 或 .atom 结尾

GET /v1/social?handle=mybrand&platforms=gitlab

Bitbucket

bitbucket, bb

1-255个字符，可使用字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=bitbucket

Dev.to

devto, dev.to

2-30个字符，可使用字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=devto

Hugging Face

huggingface, hf

1-39个字符，仅限字母数字和连字符，不能以连字符开头或结尾

GET /v1/social?handle=mybrand&platforms=huggingface

Dribbble

dribbble

1-40个字符，仅限字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=dribbble

SoundCloud

soundcloud

1-40个字符，仅限字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=soundcloud

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

Substack

substack

1-63个字符，仅限字母和数字

GET /v1/social?handle=mybrand&platforms=substack

Behance

behance

1-40个字符，仅限字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=behance

Docker Hub

dockerhub, docker

4-30个字符，仅限小写字母和数字

GET /v1/social?handle=mybrand&platforms=dockerhub

Hashnode

hashnode

1-39个字符，字母、数字和连字符；不能以连字符开头或结尾

GET /v1/social?handle=mybrand&platforms=hashnode

RubyGems

rubygems, ruby-gems

2-64个字符，字母、数字、下划线和连字符；必须包含至少一个字母

GET /v1/social?handle=mybrand&platforms=rubygems

Hacker News

hackernews, hn

1-20个字符，可使用字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=hackernews

3-20个字符，仅限字母数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=reddit

Bluesky

bluesky, bsky

3-253个字符，域名风格的用户名，仅限字母、数字、连字符和句点

GET /v1/social?handle=mybrand&platforms=bluesky

X / Twitter

x, twitter

1-15个字符，仅限字母数字和下划线

GET /v1/social?handle=mybrand&platforms=twitter

Instagram

instagram, ig

1-30个字符，仅限字母数字、下划线和句点

GET /v1/social?handle=mybrand&platforms=instagram

Facebook

facebook, fb

4-50个字符，仅限字母数字和句点

GET /v1/social?handle=mybrand&platforms=facebook

Threads

threads

1-30个字符，仅限字母数字、下划线和句点

GET /v1/social?handle=mybrand&platforms=threads

2-30个字符，仅限字母数字、下划线和句点

GET /v1/social?handle=mybrand&platforms=pinterest

Snapchat

snapchat, snap

3-15个字符，必须以字母开头，可使用拉丁字母、数字、连字符、下划线和句点，且必须以字母或数字结尾

GET /v1/social?handle=mybrand&platforms=snapchat

telegram, tg

3-32个字符，必须以字母开头，仅限字母、数字和单个下划线，末尾不能是下划线

GET /v1/social?handle=mybrand&platforms=telegram

Twitch

twitch

3-25个字符，仅限字母数字和下划线

GET /v1/social?handle=mybrand&platforms=twitch

Patreon

patreon

1-100个字符，仅限字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=patreon

TikTok

tiktok

2-24个字符，仅限字母数字、下划线和句点

GET /v1/social?handle=mybrand&platforms=tiktok

YouTube

youtube, yt

3-30个字符，仅限字母数字、下划线、句点和连字符

GET /v1/social?handle=mybrand&platforms=youtube

3-100个字符，仅限字母数字和连字符

GET /v1/social?handle=mybrand&platforms=linkedin

Steam

steam, steamcommunity

2-64个字符，字母、数字、下划线和连字符

GET /v1/social?handle=mybrand&platforms=steam

Tumblr

tumblr

1-32个字符，字母、数字及中间位置的连字符

GET /v1/social?handle=mybrand&platforms=tumblr

Vimeo

vimeo

1-64个字符，字母、数字、下划线和连字符；必须包含至少一个字母

GET /v1/social?handle=mybrand&platforms=vimeo

Letterboxd

letterboxd, lb

2-15个字符，字母、数字和下划线

GET /v1/social?handle=mybrand&platforms=letterboxd

Linktree

linktree

1-80个字符，字母、数字、句点、下划线和连字符

GET /v1/social?handle=mybrand&platforms=linktree

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

服务状态 API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

免费额度 免费注册

从每月 10,000 积分开始，只有在用量增长时再升级。

活跃请求示例

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

主要功能

即时结果

在几秒钟内获得所有平台的可用性状态。

个人资料链接

已占用处理的现有个人资料的直接链接。

摘要统计

可用与已占用平台的快速概览。

API访问

集成到您的品牌研究工作流中。

与域名结合

检查社交处理以及域名可用性。

请求示例

GET /v1/social?platforms=itchio bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=mybrand&platforms=itchio"

POST /v1/social/bulk bash

curl -X POST "https://domscan.net/v1/social/bulk" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handles":["mycompany","myproduct"],"platforms":["itchio"]}'

响应示例

200 OK json

{
  "handle": "mybrand",
  "availability": {
    "itchio": {
      "available": false,
      "profile_url": "https://mybrand.itch.io/",
      "checked": true,
      "requested": true,
      "method": "public_profile",
      "confidence": "high",
      "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。提前检查可以帮助您在需要时调整。

可以一次检查多个社交媒体用户名吗？

是的。最多可向 POST /v1/social/bulk 发送10个用户名，并可选择提供平台列表。批量检查与单次检查采用相同的单个用户名积分费率。

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

请求错误 400

参数无效

未授权 401

API 密钥或会话缺失或无效。

需要付款 402

没有足够额度来执行此请求。

请求过多 429

超出速率限制

每月可免费获得 10,000 积分。可使用任意公开 API，仅在需要时充值积分。

免费开始查看文档试用免费工具

itch.io 用户名检查器 API 接口

集成前可见的信任信号

这个 API 可以帮你交付什么

集成流程

开发者工具包

参数和响应映射

API 端点

社交句柄可用性

itch.io

API 接口

身份验证

GitHub

GitLab

Bitbucket

Dev.to

Hugging Face

Dribbble

SoundCloud

Gumroad

Buy Me a Coffee

Substack

Behance

Docker Hub

Hashnode

RubyGems

Hacker News

Reddit

Bluesky

X / Twitter

Instagram

Facebook

Threads

Pinterest

Snapchat

Telegram

Twitch

Patreon

TikTok

YouTube

LinkedIn

Steam

Tumblr

Vimeo

Letterboxd

Linktree

集成前可见的信任信号

主要功能

请求示例

响应示例

常见问题解答

相关工具和资源

HTTP 状态码