Graph API Version

Ad Account Ad Volume

Reading

Ad Volume Information for a given Ad Account

Example

Graph API Explorer
GET v24.0/...?fields={fieldname_of_type_AdAccountAdVolume} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '...?fields={fieldname_of_type_AdAccountAdVolume}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_AdAccountAdVolume}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_AdAccountAdVolume}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_AdAccountAdVolume}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
actor_id
numeric string

The actor id that the ads volume aggregated on. Currently it can only be page id.

actor_name
string

The actor name that the ads volume aggregated on. Currently it can only be page name.

ad_limit_scope_business

The ad limit for certain accounts for advertisers with account managers are defined by the ad account's Business Manager. This is the business if this account is subject to Business Manager level ad limit.

ad_limit_scope_business_manager_id
numeric string

The ad limit for certain accounts for advertisers with account managers are defined by the ad account's Business Manager. This is the Business Manager ID if this account is subject to Business Manager level ad limit.

ad_limit_set_by_page_admin
unsigned int32

The ad limit set by page admin for the business that the ad account belongs to.

ads_running_or_in_review_count
unsigned int32

Num of ads running or in review associated with given actor id

ads_running_or_in_review_count_subject_to_limit_set_by_page
unsigned int32

Number of ads running of in review in the group. If ad limit is not set by the page owner, it is null. If the ad limit is set by the page owner, it is the number of ads running or in review for the business or individual.

current_account_ads_running_or_in_review_count
unsigned int32

Num of ads running or in review under the current account associated with given actor id

future_limit_activation_date
string

starting date of ad limit that will be effective in the future

future_limit_on_ads_running_or_in_review
unsigned int32

ad limit that will be effective in the future, this limit is on number of ads running or in review for given actor

limit_on_ads_running_or_in_review
unsigned int32

limit on number of ads running or in review associated with given actor id

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.