API 文档

身份验证

API 使用基于 Django REST Framework 的令牌身份验证。所有请求必须在请求头中包含您的 API 令牌： Authorization

Authorization: Token YOUR_API_TOKEN

您的 API 令牌可在 Giant Panda 控制面板的"文档 → 身份验证"中找到。请妥善保管令牌，不要公开分享。

域名状态检查

根据主要 CPC 提供商的系统检查域名状态。支持单个和批量请求，结果缓存 24 小时。

速率限制

• 每分钟 1,000 次请求
• 每天 1,000 次请求

缓存结果不计入速率限制。

单个域名请求

curl -X POST https://account.giantpanda.com/api/v1/a/fd/check/ \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com",
    "language": "en"
  }'

批量请求（最多 100 个域名）

curl -X POST https://account.giantpanda.com/api/v1/a/fd/check/ \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {"domain": "example.com", "language": "en"},
      {"domain": "example2.com"}
    ]
  }'

响应

{
  "results": {
    "example.com": {
      "adult": false,
      "fallListed": false,
      "fallListReason": null,
      "blocked": false,
      "blockedReason": null,
      "error": null,
      "cached": true,
      "cache_exp": "23h 24m"
    }
  },
  "rate_limit": {
    "remaining_minute": 998,
    "remaining_day": 997,
    "reset_minute": "2026-04-10T22:09:00.000Z",
    "reset_day": "2026-04-10T23:00:00.000Z"
  }
}

添加域名

通过 API 批量添加域名。验证每个域名，提取 TLD，并创建域名记录。重复域名会被跟踪但不会重复创建。

请求

curl -X POST https://account.giantpanda.com/api/v1/domains/add/ \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {"name": "mydomain.com"},
      {"name": "another-domain.org"}
    ]
  }'

响应

{
  "created": ["mydomain.com", "another-domain.org"],
  "existing": ["old.com"],
  "created_count": 2,
  "existing_count": 1
}

域名统计

获取分页的域名性能指标，包括请求数、查询数、点击数、收入、RPM（每千次展示收入）和 CTR（点击率）。结果按日期和域名分组。

查询参数

请求

curl 'https://account.giantpanda.com/api/v1/domains/stats/?start_date=2026-01-01&end_date=2026-03-31&page=1&page_size=50' \
  -H 'Authorization: Token YOUR_API_TOKEN'

响应

{
  "start_date": "2026-01-01",
  "end_date": "2026-03-31",
  "stats": {
    "2026-01-01": {
      "example.com": {
        "requests": 1000,
        "queries": 800,
        "clicks": 50,
        "revenue": 25.50,
        "rpm": 25.50,
        "net": 25.50,
        "ctr": 6.25
      }
    }
  },
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_count": 100,
    "total_pages": 2,
    "has_next": true,
    "has_previous": false
  }
}