Documentation API

Authentification

L'API utilise une authentification par jeton via Django REST Framework. Toutes les requêtes doivent inclure votre jeton API dans l'en-tête : Authorization

Authorization: Token YOUR_API_TOKEN

Votre jeton API est disponible dans le tableau de bord Giant Panda sous Documentation → Authentification. Gardez votre jeton en sécurité et ne le partagez pas publiquement.

Vérificateur de Statut de Domaine

Vérifiez le statut des domaines auprès du système du fournisseur CPC principal. Prend en charge les requêtes individuelles et par lot avec des résultats mis en cache pendant 24 heures.

Limites de Débit

• 1 000 requêtes par minute
• 1 000 requêtes par jour

Les résultats mis en cache ne comptent pas dans les limites de débit.

Requête de Domaine Unique

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

Requête par Lot (jusqu'à 100 domaines)

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"}
    ]
  }'

Réponse

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

Ajouter des Domaines

Ajoutez plusieurs domaines au système via l'API. Valide chaque nom de domaine, extrait le TLD et crée des enregistrements. Les domaines en double sont suivis mais non recréés.

Requête

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"}
    ]
  }'

Réponse

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

Statistiques de Domaine

Récupérez des métriques de performance paginées incluant requêtes, recherches, clics, revenus, RPM (Revenu Pour Mille) et CTR (Taux de Clics). Résultats groupés par date et domaine.

Paramètres de Requête

Requête

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'

Réponse

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