Meta Business SDK for Python: the official way to pull your own ads data

A third-party Python wrapper around the Meta Marketing API is one API version bump away from breaking, and you find out when a scheduled report silently fails. Meta ships its own official Python SDK for exactly this reason: it covers the Marketing API, the Conversions API, the Pages API and other Business services under one first-party package, kept in step with the current API version by the people who set the version.

Why it made the cut

For custom reporting or automation over Meta ads data, a first-party SDK beats a community wrapper on the one thing that actually matters over time: it is maintained in lockstep with the API it wraps, so a breaking change on Meta's side lands as a versioned SDK release rather than a silent failure in your pipeline. That reliability is worth the extra setup step of registering a Meta app.

How to use it

1. Register a Meta app and generate an access token with Marketing API permissions.
2. Install the SDK from the GitHub repository below into your Python 3 environment.
3. Initialise the API with your app ID, app secret and access token, then call the Marketing, Conversions or Pages API objects you need.
4. Pin your installed version against the current Marketing API version noted in the release notes, and re-check both at your next Meta API upgrade.

Worth knowing

The SDK is free and open source under the Facebook Platform License, carries 1.6k GitHub stars and 672 commits, and its latest release, v25.0.3, is dated 17 July 2026, kept in step with the current Marketing API version. That release cadence is the clearest signal that this is the safer long-term choice over a third-party wrapper.

Source: https://github.com/facebook/facebook-python-business-sdk