Marketing APIs Reference
This is a full list of root nodes for the Facebook Marketing APIs, with links to the reference docs for each. The available edges are shown separately.
To gain an understanding of the architecture of the API and how to call root nodes and their edges, read the using the Graph API document.
The main root objects of the Marketing APIs are:
| Root Node | Represents |
|---|---|
An ad user is a regular Facebook user who chooses to create ads. Each user may have a role on several ad accounts | |
An ad account is an account object for managing ads | |
An ad object to define your campaigns' objective and contain one or more ad sets | |
An ad set object to contain all ads that share the same budget, schedule, bid, and targeting | |
An ad group contains the data necessary for an ad, such as creative elements and measurement information |
User
Edges of a user
| Edge | Represents |
|---|---|
A grouping of ad accounts for that user | |
All ad accounts for that user |
Ad Account
All collections of objects in the Marketing APIs sit under an ad account.
Edges of an ad account
| Edge | Represents |
|---|---|
An ad object to define your campaigns' objective and contain one or more ad sets | |
An ad set object to contain all ads that share the same budget, schedule, bid, and targeting | |
An ad group contains the data necessary for an ad, such as creative elements and measurement information | |
An ad creative object defines your ad's appearance | |
A library of images for use in ad creatives. Can be uploaded and managed independently | |
A library of videos for use in ad creatives. Can be uploaded and managed independently | |
A log of the actions taken on the ad account | |
A set of tags in the ad account used to tag similar campaigns, ad sets, or ads | |
Facebook objects (e.g. pages, apps, etc) which the ad user is an administrator of (or developer/advertiser in the case of apps) | |
Conversion data aggregated by the ad account | |
The ad account's custom audiences. Custom Audiences allow advertisers to target their ads to people with whom they already have a relationship off of Facebook | |
An API to generate ad previews | |
The conversion pixels created on the account | |
The ad account's partner categories. Partner categories are targeting clusters created by our 3rd party data providers | |
An API to generate the estimated reach of a specified targeting spec | |
A flexible reporting API to fetch ad account data and allows for scheduled reports | |
Returns a single set of statistics aggregated by the ad account | |
An API to generate human-readable description of the targeting for the ad group | |
A list of users on the ad account | |
Ad Insights API that provides a single consistent interface for insights. Features include deduping across child objects, sorting, async reports. |
Ad Campaign
Edges of an ad campaign
| Edge | Represents |
|---|---|
An ad set object to contain all ads that share the same budget, schedule, bid, and targeting. | |
An ad group contains the data necessary for an ad, such as creative elements and measurement information | |
A tagging mechanism for your campaigns to easily find similar campaigns | |
Returns a single set of statistics aggregated by campaigns | |
Ad Insights API that provides a single consistent interface for insights. Features include deduping across child objects, sorting, async reports. |
Ad Set
Edges of an ad set
| Edge | Represents |
|---|---|
An ad group contains the data necessary for an ad, such as creative elements and measurement information | |
An ad creative object is defines your ad's appearance | |
A log of the actions taken on the ad set | |
A tagging mechanism for your ad sets to easily find similar ad sets | |
Conversion data for the ad set | |
Returns a single set of statistics aggregated by ad sets | |
Ad Insights API that provides a single consistent interface for insights. Features include deduping across child objects, sorting, async reports. |
Ad
Edges of an ad
| Edge | Represents |
|---|---|
An ad creative object is defines your ad's appearance | |
A tagging mechanism for your ads to easily find similar ads | |
Conversion data for the ad | |
Returns stats per targeted keyword of the ad | |
An API to generate ad previews from the existing ad object | |
An API to generate the estimated reach for an ad | |
Returns a single set of statistics for your ad | |
An API to generate a human-readable description of the targeting for the ad group | |
An API to assign click tags to an ad. Click tracking tags allow an advertiser to specify a URL that will get fired upon a click on an ad. | |
Ad Insights API that provides a single consistent interface for insights. Features include deduping across child objects, sorting, async reports. |
Creative
Edges of a creative
| Edge | Represents |
|---|---|
An API to generate ad previews from the existing ad creative object |
