API Docs

Live

API Reference

Base URL: https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer

Authentication

All requests require an X-API-Key header. Each project has its own key:

Le Petit Chef
act_266718024641233
lpc-roi-api-2026-secret
7 Paintings
act_941675979605128
7p-roi-api-2026-secret
GET/campaignsList Campaigns

Returns all active campaigns with performance data for the selected period.

Query Parameters
NameTypeDefaultDescription
periodstringlast_7dTime range: yesterday, last_7d, last_30d
Example
curl -H "X-API-Key: lpc-roi-api-2026-secret" \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/campaigns?period=last_7d"
PATCH/campaigns/{id}/budgetUpdate Campaign Budget

Updates the daily budget of a single campaign.

Request Body
{ "daily_budget": 150.00 }
Example
curl -X PATCH \
  -H "X-API-Key: lpc-roi-api-2026-secret" \
  -H "Content-Type: application/json" \
  -d '{"daily_budget": 150}' \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/campaigns/120215870123456/budget"
PATCH/campaigns/budgetsBulk Update Budgets

Updates budgets for multiple campaigns in one request.

Request Body
{
  "updates": [
    {"campaign_id": "123456", "daily_budget": 150},
    {"campaign_id": "789012", "daily_budget": 200}
  ]
}
Example
curl -X PATCH \
  -H "X-API-Key: lpc-roi-api-2026-secret" \
  -H "Content-Type: application/json" \
  -d '{"updates": [{"campaign_id": "123", "daily_budget": 150}]}' \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/campaigns/budgets"
POST/recommendationsGet AI Recommendations

Analyzes booking data against ad spend and returns budget optimization recommendations.

Request Body
{
  "locations": [
    {"location": "Hamburg", "revenue": 15000, "bookings": 45, "pax": 180},
    {"location": "Berlin", "revenue": 8500, "bookings": 28}
  ],
  "period": "last_7d"
}
Example
curl -X POST \
  -H "X-API-Key: lpc-roi-api-2026-secret" \
  -H "Content-Type: application/json" \
  -d '{"locations": [{"location": "Hamburg", "revenue": 15000}]}' \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/recommendations"
GET/roiCalculate ROI

Calculates ROI for multiple locations by combining revenue data with ad spend.

Query Parameters
NameTypeDefaultDescription
locationsJSON stringrequired[{"location": "Hamburg", "revenue": 15000}]
periodstringlast_7dTime range
Example
curl -H "X-API-Key: lpc-roi-api-2026-secret" \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/roi?locations=%5B%7B%22location%22%3A%22Hamburg%22%2C%22revenue%22%3A15000%7D%5D"
POST/syncTrigger Manual Sync

Forces an immediate refresh of campaign data from Meta Ads API.

Example
curl -X POST \
  -H "X-API-Key: lpc-roi-api-2026-secret" \
  "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/sync"
GET/healthHealth Check

Returns API status, last sync time, and cached campaign counts.

Example
curl "https://8000-iyfmchmqupf6vr56ce8zc-37af571b.us2.manus.computer/health"