Graph API Version

Saved Audience

As part of our ongoing effort to improve how advertisers create and manage their audiences, we are making an update that affects any Custom Audience, Lookalike Audience, or Saved Audience which has not been used in any active ad sets in over two years.

For more information, see the Custom Audiences Overview documentation.

Reading

Object representing a targeting spec that has been saved for later use.

Example

Graph API Explorer
GET /v11.0/{saved-audience-id} 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(
    '/{saved-audience-id}',
    '{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(
    "/{saved-audience-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{saved-audience-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{saved-audience-id}"
                                      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
id
numeric string

ID

approximate_count
int32

Approximate reach of this saved audience as a 32 bit int

approximate_count_64bit
integer

Approximate reach of this saved audience as a 64 bit int

description
string

Description of this saved audience provided by owner

extra_info
string

extra_info

name
string

Name of this saved audience

permission_for_actions
AudiencePermissionForActions

Permissions for actions to the audience

run_status
enum

Whether the saved audience is active or deleted

sentence_lines
list

The targeting sentence lines of this saved audience

targeting
Targeting

Target spec saved in this audience

time_created
datetime

Creation time of this saved audience

time_updated
datetime

Last time the saved audience being updated by its owner

Error Codes

ErrorDescription
100Invalid parameter
368The action attempted has been deemed abusive or is otherwise disallowed

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.