Campaigns

GEThttps://api.acme.com/api/ads/facebook/campaigns

Available on Premium, Business, Enterprise plans.

Retrieve ad campaigns for a specific Facebook ad account. This endpoint provides detailed information about campaigns, including budget, status, performance metrics, and scheduling details.

The accountId parameter requires the numeric ID without the "act_" prefix
Campaign status may be one of: "ACTIVE", "PAUSED", "DELETED", "ARCHIVED", "IN_PROCESS", or "WITH_ISSUES"
The metrics object contains performance data for the campaign
The budgetRemaining field represents the remaining budget in the account's currency
Results are cached for 10 minutes to optimize performance

Header Parameters

Authorizationstringrequired

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Keystring

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Query Parameters

accountIdnumberrequired

The ID of the ad account to retrieve campaigns for.

limitnumberdefault: 100

Limit the number of campaigns returned.

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/ads/facebook/campaigns?accountId=1234567890

{
    "status": "success",
    "campaigns": [
        {
            "accountId": "8501481455633",
            "boostedObjectId": "67263320208733",
            "budgetRemaining": 0,
            "buyingType": "AUCTION",
            "campaignId": "1202176707545833",
            "configuredStatus": "PAUSED",
            "created": "2025-03-26T19:42:43-0400",
            "dailyBudget": 0,
            "effectiveStatus": "ACTIVE",
            "endDate": "2026-03-28T18:30:00-0400",
            "lifetimeBudget": 0,
            "metrics": {},
            "name": "API Post - DE6gpw8kxlonHy6eb33 - 2025-03-26T23:42:43",
            "spendCap": 0,
            "startDate": "2026-03-26T18:30:00-0400",
            "status": "ACTIVE"
        }
    ],
    "count": 1,
    "lastUpdated": "2025-03-27T00:57:15.339Z",
    "nextUpdate": "2025-03-27T01:08:15.339Z"
}