meta-ads-api Documentation
Meta Marketing API documentation. Use for Facebook/Instagram ad management, campaign creation, ad sets, creatives, audiences, targeting, bidding, insights reporting, ad rules automation, and brand safety.
Documentation Structure
contents/ ├── index.md # Overview, campaign hierarchy, endpoints ├── get-started.md # Auth, permissions, basic ad creation ├── campaigns.md # Campaign CRUD, statuses, objectives ├── creative.md # Ad formats, placements, assets, previews ├── bidding.md # Bid strategies, budgets, optimization, pacing ├── audiences.md # Custom/lookalike audiences, targeting spec ├── insights.md # Reporting, metrics, breakdowns, attribution ├── ad-rules.md # Automated ad management rules ├── brand-safety.md # Block/allow lists, content verification ├── best-practices.md # Rate limiting, batching, caching, ETags ├── troubleshooting.md # Error codes, debugging, transient errors └── reference.md # Object types, edges, CRUD, batch, pagination
Topic Guide
| Topic | Key Files |
|---|---|
| Campaign structure & hierarchy | contents/index.md, contents/campaigns.md |
| Creating ads programmatically | contents/get-started.md, contents/campaigns.md |
| Ad creatives & formats | contents/creative.md |
| Image/video upload | contents/creative.md |
| Bid strategies & budgets | contents/bidding.md |
| Campaign Budget Optimization (CBO) | contents/bidding.md |
| Custom & lookalike audiences | contents/audiences.md |
| Targeting (demographics, interests, behaviors) | contents/audiences.md |
| Performance reporting & metrics | contents/insights.md |
| Attribution windows & breakdowns | contents/insights.md |
| Automated ad rules | contents/ad-rules.md |
| Brand safety controls | contents/brand-safety.md |
| Rate limiting & error handling | contents/troubleshooting.md, contents/best-practices.md |
| API reference & object types | contents/reference.md |
| Authentication & permissions | contents/get-started.md |
| Special ad categories (housing, credit) | contents/audiences.md |
