Skip to main content
GET
Retrieve ad campaigns for a specific Instagram 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

Query Parameters

number
required
The ID of the ad account to retrieve campaigns for.
number
default:100
Limit the number of campaigns returned.