SDKs

The easiest way to develop on Marketing API. The SDKs are open-source, and provide support for authentication, core object models, tests, and stability on top of the HTTP-based API.

Download

Marketing API changes often, get the latest autogenerated SDKs which provide parity with our API.

Install PHP and Python SDKs

Install two SDKs in your development environment.

• Requirements: Webserver running PHP 5.x, e.g. Apache/XAMPP/MAMP;
• Facebook Ads API SDK for PHP / PYTHON to access the Marketing API.
• Facebook SDK for PHP to login to our app (PHP only)

/* 
  PHP Requirements:
  PHP 5.4 or greater. The SDKs use Composer to   
  manage dependencies.
*/

//Run this in terminal to get the latest Composer:
curl -sS "https://getcomposer.org/installer" | php

/*
  If you encounter issues, see 
  "https://getcomposer.org/download/" to install Composer.
 */

//Next add this to "composer.json":
{
  "require": {
    "facebook/php-sdk-v4" : "~5.0",
    "facebook/php-ads-sdk": "2.5.*"
  }
}

//Then install it through composer:
php composer.phar install --no-dev

//The SDKs and dependencies are installed under "./vendor".

'''
  Python Requirements:
  Easiest way to install the SDK is using pip.
'''

#If you don't have pip:
easy_install pip

#Clone the git hub repo on your local machine:
git clone https://github.com/facebook/facebook-python-ads-sdk.git


#then execute the following to ensure that you grab all the dependencies:
pip install facebookads

#### Note: 
# There is a dependency installation issue with Python 3.
# If you're running Python 3 and configparser fails to install, 
# manually download the package from github:
# https://github.com/facebook/facebook-python-ads-sdk.git

Access Token via SDKs, PHP only

The shows how to get a user access token using the Facebook SDK for PHP. We do not offer getting a user access token using the Python SDK.

Initialize Marketing API SDK

Once you are logged in, initialize the Marketing API SDK:

Make a simple API test call; read basic from facebookads import adobjects simple API test call; read basic ad account data with Marketing API:

// Add to header of your file
use FacebookAds\Object\AdUser;

// Add after Api::init()
$me = new AdUser('me');
$my_adaccount = $me->getAdAccounts()->current();

#Add to header of your file
from facebookads.objects import AdUser
 
#Add after FacebookAdsApi.init
me = AdUser(fbid='me')
my_account = me.get_ad_accounts()[0]

Debug the response, for example:

print_r($my_adaccount->getData());

print my_account

On success, you get an array with ad account information:

Array
(
    [account_groups] => 
    [account_id] => 123456789
    [account_status] => 
    [age] => 
    [agency_client_declaration] => ...
)

Install Ruby SDKs

• Requirements: Ruby 2.0+

Install using command line

gem install facebookads

or add the following line to your Gemfile

gem 'facebookads'

Access Tokens

FacebookAds.configure do |config|
  config.access_token = '{your-access-token}'
  config.app_secret = '{your-app-secret}'
end

Please refer to the README file in the project for detailed usage guide.

Third-party SDKs

These are unofficial, third-party SDKs for other languages and frameworks built by communities of active developers.

Inclusion in this list is not an endorsement or recommendation by Facebook. Inclusion is not intended to imply, directly or indirectly, that these organizations endorse or have any affiliation with Facebook. You should report feedback and bugs to their respective developers.

R
fbRads

Javascript
JS Ads SDK by Lucas Costa