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
  }
}