Detail

Available Fields

for more information click here

Field	Type	Description
id	String	Unique ID for an ad creative, numeric string.
account_id	String	Ad account ID for the account this ad creative belongs to
actor_id	String	The actor ID (Page ID) of this creative
adlabels	list<AdLabel>	Ad Labels associated with this creative. Used to group it with related ad objects.
applink_treatment	enum	Used for Dynamic Ads. Specify what action should occur if a person clicks a link in the ad, but the business' app is not installed on their device. For example, open a webpage displaying the product, or open the app in an app store on the person's mobile device.
asset_feed_spec		Used for Dynamic Creative to automatically experiment and deliver different variations of an ad's creative. Specifies an asset feed with multiple images, text and other assets used to generate variations of an ad. Formatted as a JSON string.

GET https://us-central1-appgregator.cloudfunctions.net/facebook/adcreative/

Query Parameters

Name	Type	Description
name*	String	ft-4
connection_name*	String	fbads-01
creative_id*	String	23852150404470549
fields*	String	id,name, object_story_id,object_story_spec,title,status,image_url

Headers

Name	Type	Description
x-api-key*	String	U2Fsd...

200: OK Success

{
    "id": "23852175881110549",
    "name": "Sample Promoted Post11 2022-09-23-8dcee2ca4dc68d500edabfce898e228b",
    "object_story_spec": {
        "page_id": "1842784136033747",
        "link_data": {
            "link": "https://facebook.com/1842784136033747",
            "message": "Creative message",
            "image_hash": "a710507a461b5d44ce4e1470a0c3f1df",
            "call_to_action": {
                "type": "LIKE_PAGE",
                "value": {
                    "page": "1842784136033747"
                }
            }
        }
    },
    "title": "Source code - Tutorial",
    "status": "ACTIVE",
    "image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t45.1600-4/307325310_23852157336180549_8292090511693966576_n.png?_nc_cat=102&ccb=1-7&_nc_sid=2aac32&_nc_ohc=2VQGN_iluBMAX-k-IKy&_nc_ht=scontent-iad3-2.xx&edm=AAT1rw8EAAAA&oh=00_AT_iOjwOH-ZKERj5wIqVh0BRWpipHlNRVvYv9WVDfQ7Lzw&oe=6331B500"
}

cURL

curl --location --request GET 'https://us-central1-appgregator.cloudfunctions.net/facebook/adcreative?name=ft-4&connection_name=fbads-01&creative_id=23852175881110549&fields=id,name, object_story_id,object_story_spec,title,status,image_url' \
--header 'x-api-key: U2Fsd...'

NodeJs - Axios

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://us-central1-appgregator.cloudfunctions.net/facebook/adcreative?name=ft-4&connection_name=fbads-01&creative_id=23852175881110549&fields=id,name, object_story_id,object_story_spec,title,status,image_url',
  headers: { 
    'x-api-key': 'U2Fsd...'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

PHP - cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://us-central1-appgregator.cloudfunctions.net/facebook/adcreative?name=ft-4&connection_name=fbads-01&creative_id=23852175881110549&fields=id,name,%20object_story_id,object_story_spec,title,status,image_url',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: U2Fsd...'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;