Get Facebook Ad Accounts

Endpoint: GET /api/ads/facebook/accounts

Filters accounts to return active ones with billing set up.

Select Post to Boost

Use:

• GET /api/history – for posts posted through Ayrshare.
• GET /api/history-platform – for all Facebook posts.

Grab the right postId.

Boost the Post

Endpoint: POST /api/ads/facebook/boost

Required: postId, accountId, goal, budget, bidAmount, age range, location, etc.

Optional: interests[], retrieved by:

GET /api/ads/facebook/interests?search=.

Monitor Performance

• GET /api/ads/facebook/ads – Get ad metrics now.
• GET /api/ads/facebook/history – Look at historical daily data.

Update Ad Status

Endpoint: PUT /api/ads/facebook/ads

Use to pause or continue the ad (status: “active” or “paused”).

📊 Popular Key Metrics That Can Be Monitored

• Spend: Cumulative and day-wise.
• Impressions / Reach
• Clicks / CTR
• Cost metrics: CPM, CPC, CPP.
• Performance by objective: Top-performing and cost-saving objectives.

💡 Popular Use Cases

• Promote limited-time deals or events.
• Retarget original content to other audiences.
• Provide white-labeled ad boosting on your SaaS platform.

In case you’ll do this and would like to use help for that:

• Generate sample code.
• Bake this into a frontend UI.
• Automating goal assignment by post type.

I can assist you with elaborating on it.