Marketing API Version

Ad Account

Represents a business, person or other entity who creates and manage ads on Facebook. Multiple people can manage an account, and each person can have one or more levels of access to an account, by specifying roles, see Ad User. For example, query for all ad sets in this ad account:

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\AdSetFields;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');
$adsets = $account->getAdSets(array(
  AdSetFields::NAME,
  AdSetFields::CONFIGURED_STATUS,
  AdSetFields::EFFECTIVE_STATUS,
));

foreach ($adsets as $adset) {
  echo $adset->{AdSetFields::NAME}.PHP_EOL;
}
from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.adset import AdSet

account = AdAccount('act_<AD_ACCOUNT_ID>')
adsets = account.get_ad_sets(fields=[AdSet.Field.name])

for adset in adsets:
    print(adset[AdSet.Field.name])
APINodeList<AdSet> adSets = new AdAccount(act_<AD_ACCOUNT_ID>, context).getAdSets()
  .requestNameField()
  .requestConfiguredStatusField()
  .requestEffectiveStatusField()
  .execute();
curl -G \
-d "fields=name" \
-d "access_token=<ACCESS_TOKEN>" \                                                     
"https://graph.facebook.com/act_<AD_ACCOUNT_ID>/adsets"

Limits

Limits on number of ad accounts per user do not apply to Business Manager API, <AD_ACCOUNT_ID>/userpermissions. See Business Manager. })

LimitValue

Maximum number of ad accounts per person

25

Maximum number of people with access, per ad account

25

Maximum number of ads per regular ad account

6000 non-archived non-deleted ads

Maximum number of ads per bulk ad account

50000 non-archived non-deleted ads

Maximum number of archived ads per ad account

100k archived ads

Maximum number of ad sets per regular ad account

6000 non-archived non-deleted ad sets

Maximum number of ad sets per bulk ad account

10000 non-archived non-deleted ad sets

Maximum number of archived ad sets per ad account

100k archived ad sets

Maximum number of ad campaigns per regular ad account

6000 non-archived non-deleted ad campaigns

Maximum number of ad campaigns per bulk ad account

10000 non-archived non-deleted ad campaigns

Maximum number of archived ad campaigns per ad account

100k archived ad campaigns

Maximum number of images per ad account

Unlimited