API 文档

通过 REST API 将应用图标数据集成到您的应用中

免费版

$0 / 永久

✓ 每日 100 次请求
✓ 每次最多 20 个图标
✓ 基础图标数据
✗ 无版本历史
✗ 无 AI 标签和颜色

专业版

身份验证

在请求头 X-API-Key 中包含您的 API Key，或作为 api_key 查询参数传递。

curl -H "X-API-Key: your_api_key" \
  https://your-domain.com/api/v1/icons

API 端点

GET/api/v1/icons

搜索和列出图标，支持多种筛选条件

参数

qstring搜索关键词（应用名称、开发者）

categorystring按分类筛选（如 games、social）

colorstring按颜色筛选（如 blue、red）

stylestring按风格筛选（如 flat、gradient）

moodstring按风格氛围筛选（如 professional、playful）

pagenumber页码（默认：1）

limitnumber每页数量（免费版最多 20，专业版最多 100）

GET/api/v1/icons/:id

获取指定图标的详细信息

GET/api/v1/categories

列出所有可用分类及图标数量

GET/api/v1/similar

使用感知哈希查找视觉相似的图标

参数

idstring要查找相似图标的图标 ID

phashstring感知哈希值（可替代 id 参数）

limitnumber最大返回数量（默认：10，最大：20）

响应示例

{
  "success": true,
  "data": [
    {
      "id": "com.instagram.ios",
      "name": "Instagram",
      "category": "social",
      "iconUrl": "https://...",
      "developer": "Meta Platforms, Inc."
    }
  ],
  "total": 47000,
  "page": 1,
  "limit": 20,
  "totalPages": 2350,
  "_meta": {
    "api_version": "v1",
    "tier": "free",
    "rate_limit": 100,
    "rate_remaining": 99
  }
}