meta-ads
Official CLI for the Meta Marketing API. Manage campaigns, ad sets, ads, creatives, catalogs, datasets, and insights from your terminal.
Installation
pip install meta-ads
Quick Start
# Set up authentication
export ACCESS_TOKEN=your_access_token
export AD_ACCOUNT_ID=act_123456
# List campaigns
meta ads campaign list
# Get ad performance insights
meta ads insights get --date-preset last_7d
# Create a campaign
meta ads campaign create --name "Sales Campaign" --objective OUTCOME_SALES --daily-budget 5000
# Output as JSON
meta ads campaign list --output json
Commands
| Command | Description |
|---|---|
meta auth |
Manage authentication |
meta ads adaccount |
Manage ad accounts (list, get, current) |
meta ads campaign |
Manage campaigns (list, get, create, update, delete) |
meta ads adset |
Manage ad sets (list, get, create, update, delete) |
meta ads ad |
Manage ads (list, get, create, update, delete) |
meta ads creative |
Manage creatives (list, get, create, update, delete) |
meta ads catalog |
Manage product catalogs (list, get, create, update, delete) |
meta ads page |
List business pages (list, get) |
meta ads product-set |
Manage product sets (list, get, create, update, delete) |
meta ads product-item |
Manage product items (list, get, create, update, delete) |
meta ads product-feed |
Manage product feeds (list, get, create, update, delete) |
meta ads dataset |
Manage datasets/pixels (list, get, create, connect, disconnect, assign-user) |
meta ads guidance |
Get ad recommendations and guidance (list) |
meta ads insights |
Query ad performance (get) |
meta ads study |
Manage ad studies / experiments (list) |
Options
-o, --output Output format: table, json, plain [default: table]
--no-color Disable colored output
--no-input Disable interactive prompts
--debug Enable debug output
--ad-account-id Meta Ad Account ID [env: AD_ACCOUNT_ID]
--business-id Meta Business ID [env: BUSINESS_ID]
The campaign, ad set, and ad list/get/create commands also accept
--fields name,other,... to fetch any Marketing API fields beyond the defaults
(names are passed straight to the API):
meta ads adset get 123456 --fields name,targeting,promoted_object,bid_strategy
Environment Variables
| Variable | Required | Description |
|---|---|---|
ACCESS_TOKEN |
Yes | Meta access token |
AD_ACCOUNT_ID |
Yes | Ad account ID (e.g. act_123456) |
BUSINESS_ID |
No | Business ID (auto-resolved from ad account if omitted) |
Requirements
- Python 3.12+
License
Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
1 maintainer
Metadata
1 maintainer
Release files for meta-ads 1.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 14.0 MB
Release files / meta_ads-1.3.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | meta_ads-1.3.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
40d72421e7041a3db4542310c423f330e82a810994e43af8b7423256d2e74589
|
|
BLAKE2b-256 checksum How to use checksums |
a44ef68aa931d4b1d4eac970d3d25297d7df1bdfd855fd88b5026ac1c5c12372
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | meta_ads-1.3.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
c8790da6a39caca39eff380394765f6ca6207d4a88ff18851aaf1ef204c4ad4f
|
|
BLAKE2b-256 checksum How to use checksums |
f7896a4c77e3c386e7db85caef74afe4ab5215d827ea0fcd49c819973cf9986d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | meta_ads-1.3.1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1fe7859d5869b9409b477c228183e6a1f5245f786d9b742a2e16c6829b32b2f1
|
|
BLAKE2b-256 checksum How to use checksums |
f562207848853ec2aa688bc641b47eeb9733fcd97a5f90ead44a0c1c70fc9b07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | meta_ads-1.3.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
dce69ab1b271493ed54ce83038471bd672716a5504ad09d41e5920271228286f
|
|
BLAKE2b-256 checksum How to use checksums |
e63f26053679fd0df6aa8b6acff457db2776c67c3d9c7bc9c6b7e669ee47effe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | meta_ads-1.3.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
56a9a46864275598e6727007482a4347da772c5e08eaa51a8c9223b3f57251aa
|
|
BLAKE2b-256 checksum How to use checksums |
0036eba37bd0949f259e46414c7baa6d38df6a086a87ad2b662560c9ad06edeb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | meta_ads-1.3.1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ec0be708d880c244dce2123b1b97e2629903b7b9ac70f73a288398a879b7941e
|
|
BLAKE2b-256 checksum How to use checksums |
679358f3b96b26fa043f224dad14bd6c9fddd7ed6966bd7641e5df202a9a8784
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | meta_ads-1.3.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e235663de9668048b0fb01d57b9afbebeaf5002d0f284774e8882de52621c94d
|
|
BLAKE2b-256 checksum How to use checksums |
e41fa98e7f28c4d7381452ddd42e87e0eb1bb5d5b1156fa92dc92c5bc2be67d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | meta_ads-1.3.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
0301105291c10234f221c84530cbc538f972b92c993691f2b8add0ad5818b4d3
|
|
BLAKE2b-256 checksum How to use checksums |
f43b2cfbfd324d2a5fbd36a3fa24d3895d384bf4994c082abf594508827df8b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meta_ads-1.3.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | meta_ads-1.3.1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
234668eda360de279e8f376ae4f76c5fe544c59863d3efecfda04be625729c6a
|
|
BLAKE2b-256 checksum How to use checksums |
0e7128f893714b18d653b52250731fd52505b68a8074dc0671df19fc7b8333aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for meta-ads 1.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
