Marketing APIs Reference
This is a full list of root nodes for the Facebook Marketing APIs, with links to reference docs for each. The available edges appear separately. For background on the API's architecture how to call root nodes and their edges, see Using the Graph API.
The main root nodes are:
| Root Node | Represents |
|---|---|
Someone on Facebook who creates ads. Each ad user can have a role on several ad accounts | |
Represents the business entity managing ads | |
Define your ad campaigns' objective. Contains one or more ad sets | |
Contains all ads that share the same budget, schedule, bid, and targeting | |
Contains information for an ad, such as creative elements and measurement information |
User
Edges
| Edge | Represents |
|---|---|
Group of ad accounts associated to this person | |
All ad accounts associated with this person | |
All pages and places that someone is an admin of | |
All promotable events you created or promotable page events that belong to pages you are an admin for | |
All domains this person can promote |
Ad Account
All collections of ad objects in Marketing APIs belong to an ad account.
Edges
| Edge | Represents |
|---|---|
Define your campaigns' objective and contain one or more ad sets | |
Contain all ads that share the same budget, schedule, bid, and targeting | |
Data for an ad, such as creative elements and measurement information | |
Defines your ad's appearance and content | |
Library of images to use in ad creatives. Can be uploaded and managed independently | |
Library of videos for use in ad creatives. Can be uploaded and managed independently | |
Log of actions taken on the ad account | |
Set of tags in the ad account. Use to tag similar campaigns, ad sets, or ads | |
Conversion data aggregated by ad sets in the ad account | |
Conversion data aggregated by ads in the ad account | |
The ad account's custom audiences. These help you target ads to people who already have a relationship with your business | |
Generate preview of ad | |
Pixels associated with this account | |
Generate the estimated reach of ad with a given targeting spec | |
Reporting API to fetch ad account data and schedule reports | |
Set of statistics aggregated by ad sets in the ad account | |
Set of statistics aggregated by ads in the ad account | |
Generate human-readable description of targeting for the ad set | |
List of people assocated with an ad account | |
Interface for insights. De-dupes results across child objects, provides sorting, and async reports. |
Ad Campaign
Edges
| Edge | Represents |
|---|---|
Contain all ads that share the same budget, schedule, bid, and targeting. | |
Data necessary for an ad, such as creative elements and measurement information | |
Tags for your campaigns. Use to easily find similar campaigns | |
Interface for insights. Features include deduping across child objects, sorting, async reports. |
Ad Set
Edges
| Edge | Represents |
|---|---|
Data necessary for an ad, such as creative elements and measurement information | |
Defines your ad's content and appearance | |
Log of actions taken on the ad set | |
Tags for your ad sets. Use to easily find similar ad sets | |
Conversion data for the ad set | |
Interfaces for insights. Features include deduping across child objects, sorting, async reports. |
Ad
Edges
| Edge | Represents |
|---|---|
Defines your ad's appearance and content | |
Tags for your ads. Use to find similar ads | |
Conversion data for the ad | |
Returns stats per targeted keyword for ad | |
Generate ad previews from an existing ad | |
Get the estimated reach for an ad | |
Get a human-readable description of the targeting for the ad set | |
Interface for insights. Features include deduping across child objects, sorting, async reports. |