API 文档 - BrandBase

BrandBase Open API

BrandBase 开放 API 允许开发者将品牌数据、G-CVI 评分集成到自己的应用中。以下是目前可用的 API 端点和计划中的功能。

🚀 API v1 已上线！如需接入请邮件联系获取 API Key。

📋 已开放端点

GET /api/v1/brands — 品牌列表（支持分页、排序、行业筛选）
GET /api/v1/brands/:id — 品牌详情（含 G-CVI 评分、五维数据、品牌故事）
GET /api/v1/brands/search?q=keyword — 品牌搜索（中英文关键词匹配）

🔮 计划中端点

GET /api/v1/gcvi/:brand_id — G-CVI体系详情（含五维雷达数据）
GET /api/v1/industries — 行业分类与统计
GET /api/v1/ranking — 品牌排行榜（按行业/评分/地区）
POST /api/v1/claim — 品牌认领申请（需认证）

📐 通用规范

认证方式：API Key（Header: X-API-Key）
响应格式：JSON
速率限制：免费版 100次/小时，付费版 1000次/小时
数据更新频率：每日自动同步

💡 使用示例

获取品牌列表：

curl -H "X-API-Key: YOUR_KEY" https://brandbase.cn/api/v1/brands?page=1&page_size=10&sort_by=gcvl_score&order=DESC

早期接入请联系 brandbase@wheatbrand.com