Graph API Version

Archived Ad

An ad Facebook stores in the Ad Library. You can perform keyword searches or search by Page ID of ads stored in the Ad Library. See Ad Library and Ad Library API.

Reading

An archived ad.

Example

Graph API Explorer

GET v8.0/...?fields={fieldname_of_type_ArchivedAd} 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_ArchivedAd}',
    '{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_ArchivedAd}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_ArchivedAd}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_ArchivedAd}"
                                      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

Field	Description
`id` numeric string	ID for the archived ad object.
`ad_creation_time` string	The UTC date and time when someone created the ad. This is not the same time as when the ad ran. Includes date and time separated by `T`. Example: `2019-01-24T19:02:04+0000`, where `+0000` is the UTC offset.
`ad_creative_body` string	The text which displays in the ad. Typically 90 characters. See Reference, Ad Creative.
`ad_creative_link_caption` string	If an ad contains a link, the text that appears in the link.
`ad_creative_link_description` string	If an ad contains a link, any text description that appears next to the link, such as a caption or description.
`ad_creative_link_title` string	If an ad contains a link, any title provided.
`ad_delivery_start_time` string	Date an time when an advertiser wants Facebook to start delivering an of the ad. Provided in UTC as in `ad_creation_time`. Default
`ad_delivery_stop_time` string	The time when an advertiser wants to stop delivery of their ad. If this is blank, Facebook runs the ad until the advertiser stops it or they spend their entire campaign budget. In UTC. Default
`ad_snapshot_url` string	String with URL link which displays the archived ad. This displays uncompressed images and videos from the ad. Note that you cannot currently download a batch of archived ads, however you can download ad creative such as images and text for an individual ad. If you do so, it must be for analysis and you must comply with the data storage terms in Facebook Terms of Service. Default
`currency` string	The currency used to pay for the ad, as an ISO currency code
`demographic_distribution` list<AudienceDistribution>	The demographic distribution of people reached by the ad. Provided as age ranges and gender. Age ranges: Can be one of 18-24, 25-34, 35-44, 45-54, 55-64, 65+ Gender: Can be the following strings: "Male", "Female", "Unknown"
`funding_entity` string	A string containing the name of the person, company, or entity that provided funding for the ad. Provided by the purchaser of the ad.
`impressions` InsightsRangeValue	A string containing the number of times the ad created an impression. In ranges of: <1000, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K-200K, 200K-500K, >1M
`page_id` numeric string	ID of the Facebook Page that ran the ad. Default
`page_name` string	Name of the Facebook Page which ran the ad.
`potential_reach` InsightsRangeValue	This is an estimate of the size of the audience that's eligible to see this ad. It's based on targeting criteria, ad placements and how many people were shown ads on Facebook apps and services in the past 30 days. This is not an estimate of how many people will actually see this ad, and the number may change over time. It isn't designed to match population or census estimates.
`publisher_platforms` list<enum>	A list of platforms where the archived ad appeared, such as Facebook or Instagram.
`region_distribution` list<AudienceDistribution>	Regional distribution of people reached by the ad. Provided as a percentage and where regions are at a sub-country level.
`spend` InsightsRangeValue	A string showing amount of money spent running the ad as specified in `currency`. This is reported in ranges; <100, 100-499, 500-999, 1K-5K, 5K-10K, 10K- 50K, 50K-100K, 100K-200K, 200K-500K, >1M

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.