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

macOS (Homebrew, prebuilt bottle — no compiler needed):

brew tap facebook/fb
brew install meta-ads

The installed binary is meta either way.

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

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

Requirements

• Python 3.12+

License

Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.