Documentation API

Intégrez les analytics créateurs dans vos applications

Authentification

Utilisez votre clé API dans le header Authorization.

Authorization: Bearer your_api_key

Vous pouvez générer vos clés API dans Paramètres > Clés API. Gardez vos clés secrètes.

Endpoints

Tous les endpoints sont préfixés par /api. Les paramètres platform et username sont obligatoires.

GET/v1/stats

GET /v1/stats — Stats légères d'un créateur (rapide, ~2-5s)

Requête

curl -X GET "https://influal.com/api/v1/stats?platform=tiktok&username=charlidamelio" \
  -H "Authorization: Bearer your_api_key"

Réponse

{
  "success": true,
  "data": {
    "followers": 155200000,
    "shortFormatAvg": 4200000,
    "longFormatAvg": null,
    "engagementRate": 0.042,
    "engagementRateMedian": 0.038,
    "viewsMedian": 3800000,
    "postingFrequency": "daily",
    "email": null
  },
  "meta": {
    "scrapedAt": "2026-02-16T12:00:00.000Z",
    "responseTimeMs": 1240,
    "creditsUsed": 1
  }
}
GET/v1/analyze

GET /v1/analyze — Profil complet + métriques (sans vidéos, ~10-30s)

Requête

curl -X GET "https://influal.com/api/v1/analyze?platform=instagram&username=cristiano" \
  -H "Authorization: Bearer your_api_key"

Réponse

{
  "success": true,
  "data": {
    "username": "cristiano",
    "displayName": "Cristiano Ronaldo",
    "platform": "instagram",
    "followers": 636000000,
    "following": 583,
    "isVerified": true,
    "bio": "...",
    "shortFormatAvg": 18500000,
    "engagementRate": 0.012,
    "viewsMedian": 15200000,
    "postingFrequency": "3-4x/week"
  },
  "meta": {
    "scrapedAt": "2026-02-16T12:00:00.000Z",
    "responseTimeMs": 3420,
    "creditsUsed": 1
  }
}
GET/v1/analyze/full

GET /v1/analyze/full — Profil complet + métriques + jusqu'à 500 vidéos

Requête

curl -X GET "https://influal.com/api/v1/analyze/full?platform=youtube&username=MrBeast" \
  -H "Authorization: Bearer your_api_key"

Réponse

{
  "success": true,
  "data": {
    "username": "MrBeast",
    "displayName": "MrBeast",
    "platform": "youtube",
    "followers": 345000000,
    "engagementRate": 0.045,
    "videos": [
      {
        "id": "abc123",
        "title": "...",
        "views": 142000000,
        "likes": 5400000,
        "comments": 312000,
        "duration": 842,
        "engagement_rate": 0.040,
        "url": "https://youtube.com/watch?v=abc123",
        "thumbnail": "https://..."
      }
    ]
  },
  "meta": {
    "scrapedAt": "2026-02-16T12:00:00.000Z",
    "responseTimeMs": 5120,
    "creditsUsed": 1
  }
}
POST/v1/analyze-post

POST /v1/analyze-post — Analyse d'un post/vidéo par URL

Requête

curl -X POST "https://influal.com/api/v1/analyze-post" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.tiktok.com/@charlidamelio/video/1234567890" }'

Réponse

{
  "success": true,
  "data": {
    "id": "1234567890",
    "caption": "...",
    "views": 8200000,
    "likes": 1100000,
    "comments": 24000,
    "shares": 56000,
    "engagement_rate": 0.143,
    "duration": 32,
    "url": "https://www.tiktok.com/@charlidamelio/video/1234567890"
  },
  "meta": {
    "scrapedAt": "2026-02-16T12:00:00.000Z",
    "responseTimeMs": 2100,
    "creditsUsed": 1
  }
}
GET/v1/search

GET /v1/search — Recherche de créateurs par nom

Requête

curl -X GET "https://influal.com/api/v1/search?platform=tiktok&query=fitness" \
  -H "Authorization: Bearer your_api_key"

Réponse

{
  "success": true,
  "data": [
    {
      "username": "fitnessguru",
      "displayName": "Fitness Guru",
      "followers": 2400000,
      "profilePic": "https://..."
    }
  ],
  "meta": {
    "scrapedAt": "2026-02-16T12:00:00.000Z",
    "responseTimeMs": 890,
    "creditsUsed": 1
  }
}

Tarification

Pay-as-you-go, facturé mensuellement

EndpointCoût
/v1/stats0.02
/v1/analyze0.05
/v1/analyze/full0.10
/v1/analyze-post0.03
/v1/search0.01

Rate Limits

Les limites de requêtes dépendent de votre plan.

PlanLimite
Business60 req/min
Ultra120 req/min

Les headers de réponse contiennent les informations de rate limit :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1708099260

Codes d'erreur

L'API retourne des codes HTTP standards en cas d'erreur.

CodeDescription
400Requête invalide — paramètres manquants ou incorrects
401Clé API invalide ou manquante
403Plan insuffisant pour l'accès API
404Créateur ou ressource introuvable
429Rate limit dépassé
500Erreur serveur

Exemple de réponse d'erreur

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please retry after the reset window.",
    "retryAfter": 42
  }
}

Influal API v1 — Besoin d'aide ? Contactez-nous.