Skip to content

AI Recommendations

Get smart, actionable recommendations powered by Claude AI to optimize your business performance and increase profitability.

GET /v1/recommendations

Get active AI recommendations based on your business data.

Parameters

ParameterTypeRequiredDescription
categorystringNoFilter by category: profit, ads, products, costs, all (default: all)
prioritystringNoFilter by priority: high, medium, low, all (default: all)
statusstringNoactive, dismissed, applied, all (default: active)
limitnumberNoNumber of recommendations (default: 20)

Example Request

bash
curl -H "Authorization: Bearer looha_your_api_key" \
  "https://api.looha.app/v1/recommendations?category=profit&priority=high"

Response

json
{
  "success": true,
  "data": {
    "recommendations": [
      {
        "id": "rec_123",
        "category": "profit",
        "priority": "high",
        "title": "Reduce costs on low-margin products",
        "description": "3 products have profit margins below 15%. Consider negotiating better supplier prices or increasing prices.",
        "impact": {
          "type": "profit_increase",
          "estimated": 4500,
          "confidence": "high"
        },
        "actionItems": [
          "Review pricing for SKU: LB-005 (current margin: 12%)",
          "Negotiate with supplier for SKU: WH-008",
          "Consider discontinuing SKU: KB-012 (margin: 8%)"
        ],
        "affectedProducts": ["prod_789", "prod_456", "prod_234"],
        "createdAt": "2024-01-25T10:00:00Z",
        "status": "active"
      },
      {
        "id": "rec_456",
        "category": "ads",
        "priority": "high",
        "title": "Pause underperforming ad campaigns",
        "description": "2 campaigns have Profit ROAS below 1.0, meaning you're losing money on these ads.",
        "impact": {
          "type": "cost_reduction",
          "estimated": 2000,
          "confidence": "high"
        },
        "actionItems": [
          "Pause 'Summer Collection' campaign (Profit ROAS: 0.8)",
          "Review targeting for 'Weekend Sale' campaign (Profit ROAS: 0.9)"
        ],
        "affectedCampaigns": ["camp_789", "camp_012"],
        "createdAt": "2024-01-24T14:30:00Z",
        "status": "active"
      }
    ],
    "meta": {
      "total": 12,
      "showing": 2,
      "potentialSavings": 6500
    }
  }
}

POST /v1/recommendations/:id/dismiss

Dismiss a recommendation.

Example Request

bash
curl -X POST \
  -H "Authorization: Bearer looha_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Already addressed"}' \
  "https://api.looha.app/v1/recommendations/rec_123/dismiss"

POST /v1/recommendations/:id/apply

Mark a recommendation as applied.


Next: Alerts & Notifications →

Profit analytics platform for Saudi e-commerce merchants