Hugging Face's logo

Spaces:
renwei2024
/
meta-ads-api
Sleeping

App Files Community
meta-ads-api / README.md
Wei Ren
Switch model from gpt-5-mini to gpt-4o
3417789
preview code
|
raw
history blame contribute delete
2.62 kB

A newer version of the Gradio SDK is available: 6.9.0

Upgrade
metadata 
title: Meta Ads Api
emoji: 💬
colorFrom: yellow
colorTo: purple
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Use Meta Ads API to retrieve info about Meta ads

Meta Ads API Agent

An AI agent powered by smolagents that helps you retrieve information about your Meta advertising campaigns using the Facebook Business SDK.

Features

  • 🤖 AI-Powered Agent: Uses OpenAI's gpt-4o model with smolagents framework
  • 🛠️ Custom Tools: Built with Facebook Business SDK for Meta Ads operations
  • 💬 Chat Interface: User-friendly Gradio interface for natural language queries
  • 📊 Comprehensive Data: Access ad accounts, campaigns, ad sets, ads, and performance insights

Available Tools

The agent has access to the following custom tools:

  1. Get Ad Accounts: Retrieve all accessible Meta ad accounts
  2. Get Campaigns: Get campaigns for a specific ad account
  3. Get Ad Sets: Get ad sets for a specific campaign
  4. Get Ads: Get ads for a specific ad set
  5. Get Ad Insights: Retrieve performance metrics and insights

Required Space Secrets

To use this agent, you need to configure the following secrets in your Hugging Face Space:

  • OPENAI_API_KEY: Your OpenAI API key (required)
  • META_ACCESS_TOKEN: Your Meta access token (required)
  • META_APP_ID: Your Meta app ID (optional)
  • META_APP_SECRET: Your Meta app secret (optional)

Example Queries

  • "Show me all my ad accounts"
  • "Get campaigns for account act_123456789"
  • "Get ad sets for campaign 123456789"
  • "What are the insights for my account in the last 30 days?"
  • "Show me the performance of campaign 123456789 last week"

Technology Stack

How It Works

  1. User submits a natural language query through the Gradio chat interface
  2. The smolagents Code Agent processes the query
  3. The agent selects and executes the appropriate Meta Ads tools
  4. Results are returned in a human-readable format

Setup

  1. Get your Meta access token from Meta for Developers
  2. Get your OpenAI API key from OpenAI Platform
  3. Add the secrets to your Hugging Face Space settings
  4. Start chatting with the agent!