BestDogBox - Dog Breed Data & Subscription Box Rankings

🐕 BestDogBox API

免费的犬种数据库和 API。 收录 346 个犬种，提供详细的体型、性情、寿命、精力水平和护理要求信息。另提供排名靠前的订阅盒数据。

由 BestDogBox.com 构建并维护——独立的犬类产品评测和犬种指南。

---

安装

Node.js SDK

npm install bestdogbox

MCP 服务（适用于 Cursor、Claude、Windsurf）

npm install -g @bestdogbox/mcp-server

编辑器配置请参阅 MCP 设置说明。

---

快速入门

所有请求都需要 API 密钥。 在 bestdogbox.com/developers 免费注册。

# Get your free API key first, then:
curl -H "x-api-key: YOUR_API_KEY" https://bestdogbox.com/api/v1/breeds?limit=5

包含的数据

数据	数量	格式
犬种	346	JSON
订阅盒	10+ 个排名	JSON
体型类别	5（玩具型、小型、中型、大型、巨型）	—
犬种组别	8（运动犬、猎犬、工作犬、梗犬、玩具犬、牧羊犬、非运动犬、其他）	—
每个犬种的属性	15+	—

基础 URL

https://bestdogbox.com/api/v1

身份验证

将 API 密钥作为查询参数或标头传递：

# Query parameter
curl https://bestdogbox.com/api/v1/breeds?apikey=YOUR_API_KEY

# Header (recommended)
curl -H "x-api-key: YOUR_API_KEY" https://bestdogbox.com/api/v1/breeds

端点

列出所有犬种

GET /breeds?page=1&limit=50&size=large&group=sporting&search=retriever

参数	类型	说明
page	int	页码（默认值：1）
limit	int	每页结果数，最多 50（默认值：50）
size	string	筛选：玩具型、小型、中型、大型、巨型
group	string	按 AKC 组别筛选
search	string	按名称搜索犬种

获取单个犬种

GET /breeds/:slug

curl -H "x-api-key: YOUR_KEY" https://bestdogbox.com/api/v1/breeds/golden-retriever

比较两个犬种

GET /breeds/compare?a=golden-retriever&b=labrador-retriever

顶级订阅盒

GET /subscription-boxes?limit=10

按综合评分返回排名靠前的犬类订阅盒（编辑分析 + Reddit 评价 + Trustpilot 评分）。

响应示例

{
  "data": {
    "name": "Golden Retriever",
    "slug": "golden-retriever",
    "akc_group": "Sporting",
    "size": "large",
    "origin": "Scotland",
    "weight_min": 55,
    "weight_max": 75,
    "weight_unit": "lbs",
    "height_min": 21.5,
    "height_max": 24,
    "height_unit": "inches",
    "lifespan_min": 10,
    "lifespan_max": 12,
    "temperament": ["Intelligent", "Friendly", "Devoted", "Reliable"],
    "activity_level": "high",
    "grooming_needs": "moderate",
    "chewing_strength": "strong",
    "popularity_rank": 3
  },
  "meta": {
    "source": "BestDogBox.com",
    "profile": "https://bestdogbox.com/breeds/golden-retriever"
  }
}

使用示例

JavaScript

const res = await fetch('https://bestdogbox.com/api/v1/breeds/golden-retriever', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
});
const { data } = await res.json();
console.log(`${data.name}: ${data.lifespan_min}-${data.lifespan_max} years`);

Python

import requests

res = requests.get(
    'https://bestdogbox.com/api/v1/breeds',
    params={'size': 'large', 'apikey': 'YOUR_API_KEY'}
)
breeds = res.json()['data']
for breed in breeds:
    print(f"{breed['name']} — {breed['size']}")

速率限制

方案	每日限制	价格
已注册	每天 1,000 个请求	免费

速率限制每天 UTC 午夜重置。需要更高的限制？请联系 [email protected]。

错误代码

代码	含义
400	请求错误——请检查参数
401	未授权——缺少或 API 密钥无效
403	禁止访问——API 密钥已停用
404	未找到——犬种别名不存在
429	请求过多——请等到 UTC 午夜
500	服务器错误——请稍后重试

相关资源

• 完整 API 文档 — 提供注册功能的交互式文档
• 犬种档案 — 提供照片和护理指南的详细犬种页面
• 犬种比较工具 — 并排比较犬种
• 犬类热量计算器 — 考虑犬种因素的热量计算器
• 最佳犬类订阅盒 — 根据体型和犬种需求排名

署名

此数据可在 MIT 许可证下免费使用。欢迎注明来源：

Data provided by BestDogBox.com (https://bestdogbox.com)

贡献

发现犬种数据有误？请提交问题或拉取请求。合并前，我们会对照 AKC 和犬种俱乐部的来源核实所有更改。

联系方式

• 网站：bestdogbox.com
• API 文档：bestdogbox.com/developers
• 邮箱：[email protected]

---

由 BestDogBox 倾情打造 🐾