Back to Catalog
📢

Meta Ads API

Marketing & Paid Ads

Advertising API for Facebook, Instagram, and Audience Network campaigns.

Retrieve ad spend, reach, ROAS (Return on Ad Spend), conversion events, ad set performance, and demographic breakdowns.

Details

Auth Type
Bearer Token
Rate Limit
200 calls/hour per user
Pricing
Usage-Based
Full Docs
Step 1: Save your provider key

This is NOT your Callio key. Enter the API key from the provider's dashboard (e.g. OpenAI/SendGrid).

Bearer Token

1. Go to Meta for Developers portal. 2. Select your App → Marketing API → Tools. 3. Generate a System User Access Token with ads_read permissions.

Get API Credentials

Getting Started

1

Try It Instantly

Click "Try It" above to test the API in the playground

2

Add to Your Agent

Click "Add to Agent" to get your API key and integrate

Common Use Cases

Ad spend & ROAS tracking
Social campaign analytics
Ad set optimization
Audience insights

💻 Code Examples

Get started quickly with these code examples in your favorite language

curl -X GET \
'https://www.callio.dev/api/proxy/meta-ads/forward?target=https%3A%2F%2Fgraph.facebook.com%2Fendpoint' \
-H 'Authorization: Bearer YOUR_CALLIO_KEY' \
-H 'Content-Type: application/json'

💡 Tip: Replace YOUR_CALLIO_KEY with your actual Callio API key from the dashboard.

Ready to integrate Meta Ads API?

Test endpoints live or generate your API key and start building in minutes

Browse More APIs