Marketing API Version

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

/{USER}

Someone on Facebook who creates ads. Each ad user can have a role on several ad accounts

/act_{AD_ACCOUNT_ID}

Represents the business entity managing ads

/{CAMPAIGN_ID}

Define your ad campaigns' objective. Contains one or more ad sets

/{AD_SET_ID}

Contains all ads that share the same budget, schedule, bid, and targeting

/{AD_ID}

Contains information for an ad, such as creative elements and measurement information

User

Edges

Edge Represents

/adaccountgroups

Group of ad accounts associated to this person

/adaccounts

All ad accounts associated with this person

/accounts

All pages and places that someone is an admin of

/promotable_events

All promotable events you created or promotable page events that belong to pages you are an admin for

/promotable_domains

All domains this person can promote

Ad Account

All collections of ad objects in Marketing APIs belong to an ad account.

Edges

Edge Represents

/campaigns

Define your campaigns' objective and contain one or more ad sets

/adsets

Contain all ads that share the same budget, schedule, bid, and targeting

/ads

Data for an ad, such as creative elements and measurement information

/adcreatives

Defines your ad's appearance and content

/adimages

Library of images to use in ad creatives. Can be uploaded and managed independently

/advideos

Library of videos for use in ad creatives. Can be uploaded and managed independently

/activities

Log of actions taken on the ad account

/adtags

Set of tags in the ad account. Use to tag similar campaigns, ad sets, or ads

/adcampaignconversions

Conversion data aggregated by ad sets in the ad account

/adgroupconversions

Conversion data aggregated by ads in the ad account

/customaudiences

The ad account's custom audiences. These help you target ads to people who already have a relationship with your business

/generatepreviews

Generate preview of ad

/offsitepixels

Pixels associated with this account

/partnercategories

The ad account's partner categories. These are targeting options created by third-party data providers

/reachestimate

Generate the estimated reach of ad with a given targeting spec

/reportstats

Reporting API to fetch ad account data and schedule reports

/adcampaignstats

Set of statistics aggregated by ad sets in the ad account

/adgroupstats

Set of statistics aggregated by ads in the ad account

/targetingsentencelines

Generate human-readable description of targeting for the ad set

/users

List of people assocated with an ad account

/insights

Interface for insights. De-dupes results across child objects, provides sorting, and async reports.

Ad Campaign

Edges

Edge Represents

/adsets

Contain all ads that share the same budget, schedule, bid, and targeting.

/ads

Data necessary for an ad, such as creative elements and measurement information

/adtags

Tags for your campaigns. Use to easily find similar campaigns

/stats

Return a single set of statistics aggregated by campaigns

/insights

Interface for insights. Features include deduping across child objects, sorting, async reports.

Ad Set

Edges

Edge Represents

/ads

Data necessary for an ad, such as creative elements and measurement information

/adcreatives

Defines your ad's content and appearance

/activities

Log of actions taken on the ad set

/adtags

Tags for your ad sets. Use to easily find similar ad sets

/conversions

Conversion data for the ad set

/stats

Set of statistics aggregated by ad sets

/insights

Interfaces for insights. Features include deduping across child objects, sorting, async reports.

Edges

Edge Represents

/adcreatives

Defines your ad's appearance and content

/adtags

Tags for your ads. Use to find similar ads

/conversions

Conversion data for the ad

/keywordstats

Returns stats per targeted keyword for ad

/previews

Generate ad previews from an existing ad

/reachestimate

Get the estimated reach for an ad

/stats

Set of statistics for your ad

/targetingsentencelines

Get a human-readable description of the targeting for the ad set

/trackingtag

Assign click tags to an ad. With click tracking tags , specify a URL that fires when someone clicks an ad.

/insights

Interface for insights. Features include deduping across child objects, sorting, async reports.

Creative

Edges

Edge Represents

/previews

Generate ad previews from the existing ad creative object