FROGED AI API

This API provides AI-driven predictions for customer churn based on various customer interactions.

API Authentication

Include your API key in the request header:

x-api-key: your_generated_api_key

Using cURL (Windows)

curl -X POST -H "Content-Type: application/json" -H "x-api-key: your_generated_api_key" -d "{\"FirstPurchaseOrSubscription\": 1, \"SubscriptionRenewal\": 0, \"FeatureExploration\": 1, \"NotificationReceived\": 1, \"SatisfactionSurvey\": 1, \"PersonalizedRecommendations\": 1}" https://api-ai.froged.com/predict

Using cURL (Unix/Linux/MacOS)

curl -X POST     -H "Content-Type: application/json"     -H "x-api-key: your_generated_api_key"     -d '{
        "FirstPurchaseOrSubscription": 1,
        "SubscriptionRenewal": 0,
        "FeatureExploration": 1,
        "NotificationReceived": 1,
        "SatisfactionSurvey": 1,
        "PersonalizedRecommendations": 1
    }'     https://api-ai.froged.com/predict

Using Postman

Request Configuration:

Using JavaScript Fetch API

fetch('https://api-ai.froged.com/predict', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'x-api-key': 'your_generated_api_key'
    },
    body: JSON.stringify({
        FirstPurchaseOrSubscription: 1,
        SubscriptionRenewal: 0,
        FeatureExploration: 1,
        NotificationReceived: 1,
        SatisfactionSurvey: 1,
        PersonalizedRecommendations: 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Risk Level Classification

The API now provides detailed risk assessment with the following levels:

High Risk (≥ 30%)

Medium Risk (15% - 29.99%)

Low Risk (< 15%)

Sample Response

{
    "churn_probability": 0.23,
    "risk_level": "MEDIUM",
    "risk_status": 1,
    "risk_interpretation": {
        "HIGH": "Customer at high risk of churn. Immediate action required.",
        "MEDIUM": "Customer showing signs of potential churn. Close monitoring needed.",
        "LOW": "Customer currently stable."
    },
    "percentile_context": {
        "high_risk_threshold": 0.30,
        "medium_risk_threshold": 0.15,
        "typical_churn_rate": 0.10
    }
}

Rate Limits