#1 TikTok Ads Spy Tool

A Better Way to Make TikTok Ads Dropshipping & TikTok For Business

  • Find TikTok winning products & TikTok dropshipping ads.
  • Analyze TikTok advertisers
  • Get the Latest TikTok Shop Data.
Try It Free

Mastering the Facebook API: Graph API, Access Tokens, and Developer Documentation

Published on: November 17 2023 by kitchn_io

Mastering the Facebook API: Graph API, Access Tokens, and Developer Documentation

Table of Contents

  1. Introduction
  2. Getting Started with the Facebook Ads API
    • Creating a Facebook app
    • Obtaining an access token
  3. Understanding the Basics of the Facebook Ads API
    • Object Types and IDs
    • Using Edges and Parameters
  4. Accessing Campaign Data with the Facebook Ads API
    • Retrieving Campaigns and Insights
    • Analyzing Performance Metrics
  5. Managing Ad Sets and Ads
    • Modifying Daily Budgets
    • Getting Ad Performance Data
  6. Exploring Ad Creatives and Object Stories
    • Accessing Ad Creative Information
    • Analyzing Object Stories
  7. Pulling Data into Google Sheets
    • Using ImportJSON to import data
  8. Conclusion


In this article, we will delve into the fundamentals of the Facebook Ads API. We will explore how to create a Facebook app, obtain an access token, and make API calls to retrieve various data related to campaigns, ad sets, and ads. Additionally, we will cover topics such as managing budgets, analyzing performance metrics, and accessing ad creative information. Finally, we will discuss how to pull data from the Facebook Ads API into Google Sheets for further analysis and reporting.

Getting Started with the Facebook Ads API

To begin using the Facebook Ads API, you need to create a Facebook app. This app serves as the connection between your account and the API. Once the app is created, you can obtain an access token, which is essentially a combination of a username and password for your app. With the access token, you can make API calls to retrieve data and perform various actions.

Creating a Facebook App

To create a Facebook app, visit the Facebook Developers website and navigate to the "Create App" section. Follow the prompts to provide a name for your app and select the necessary permissions and settings. Once the app is created, you will receive an App ID, which you will need later to generate an access token.

Obtaining an Access Token

There are two ways to obtain an access token. The first method is to use the "Get Token" tool in the API Explorer. This allows you to choose the necessary permissions and generate an access token specific to those permissions. The second method is to use the Graph API Explorer. From there, you can generate a user access token by logging in with your Facebook account and selecting the required permissions. Both methods will provide you with an access token that can be used to make API calls.

Understanding the Basics of the Facebook Ads API

The Facebook Ads API revolves around three main elements: objects, edges, and parameters.

Object Types and IDs

Objects in the Facebook Ads API represent entities such as ad accounts, campaigns, ad sets, and ads. Each object has a unique ID that can be used to access and manipulate its data. For example, you can retrieve information about a specific campaign by specifying its campaign ID in an API request.

Using Edges and Parameters

Edges are objects that are related to another object. For instance, an ad account has edges for campaigns, ad sets, and ads. By querying these edges, you can retrieve related objects. Parameters, on the other hand, allow you to customize the data you want to retrieve. You can filter, sort, or limit the data by including parameter values in your API requests. For example, you can request only active campaigns from an ad account by specifying the appropriate parameter.

Accessing Campaign Data with the Facebook Ads API

One of the primary use cases of the Facebook Ads API is retrieving data related to campaigns. By making API calls, you can retrieve information about campaigns, such as their names, budgets, and performance metrics.

Retrieving Campaigns and Insights

To retrieve campaigns, you can use the appropriate edge in the API, specifying the ad account ID. This will return a list of campaigns associated with that ad account. Additionally, you can request insights for a specific campaign, allowing you to access performance metrics such as spend, impressions, and click-through rates. By specifying a time frame and applying filters, you can further refine the data you retrieve.

Analyzing Performance Metrics

Once you have retrieved insights for your campaigns, you can analyze the performance metrics to gain valuable insights. You can compare metrics across different campaigns, identify trends, and assess the effectiveness of your advertising efforts. By understanding the performance data, you can make informed decisions to optimize your campaigns and achieve better results.

Managing Ad Sets and Ads

The Facebook Ads API also enables you to manage ad sets and ads, giving you the ability to modify budgets, retrieve performance data, and make other changes.

Modifying Daily Budgets

With the Facebook Ads API, you can easily modify the daily budgets of your ad sets. By specifying the ad set ID and the desired budget, you can make API calls to update the budget. This allows you to dynamically adjust your ad spending based on performance and other factors.

Getting Ad Performance Data

To evaluate the performance of your ads, you can retrieve various metrics using the Facebook Ads API. By querying the API for specific ad sets or ad IDs, you can gather data on impressions, clicks, engagement, and other relevant metrics. This data can help you make data-driven decisions to optimize your ad campaigns and improve their effectiveness.

Exploring Ad Creatives and Object Stories

The ad creative is an essential element of any Facebook ad. With the Facebook Ads API, you can access information about ad creatives and understand how they contribute to the overall performance of your campaigns.

Accessing Ad Creative Information

To analyze ad creative data, you can retrieve the object story specification for each ad creative. This specification provides details about the Facebook page, Instagram account, caption, and call-to-action type associated with the ad creative. By understanding the elements of a successful ad creative, you can refine your advertising strategies and improve your campaign performance.

Analyzing Object Stories

Object stories are an integral part of ad creatives. They provide additional context and information about the ad, contributing to its overall effectiveness. By examining the object story specification, you can gain insights into the components that make a compelling ad.

Pulling Data into Google Sheets

To further analyze and visualize your Facebook Ads API data, you can import it into Google Sheets. Using tools like ImportJSON, you can easily retrieve data from the API and populate your spreadsheets. This allows you to create customized reports, track performance over time, and gain a deeper understanding of your advertising efforts.


The Facebook Ads API is a powerful tool that grants access to a wealth of data and features to optimize your advertising campaigns. By leveraging the API's capabilities, you can retrieve detailed campaign information, analyze performance metrics, manage budgets, and gain insights into ad creatives. Additionally, integrating the API with Google Sheets enables you to further analyze and organize your data for reporting and visualization purposes. With a comprehensive understanding of the Facebook Ads API, you can enhance your advertising strategies and maximize your campaign results.

Start your free trial today!

Try Pipiads free for trial, no credit card required. By entering your email,
You will be taken to the signup page.