Available on Premium, Business, Enterprise plans.

​
Introduction to the Ads API

The Ayrshare Ads API provides programmatic access to create, manage, and analyze social media ads.

Currently supporting Facebook, the Facebook Ads API, also known as the Facebook Marketing API, allows you to transform existing posts into paid advertisements. This includes boosting posts (transforming a post into an ad), managing ads, tracking performance, and analyzing ad spend.

Ads created and updated via Ayrshare can always be found in the Facebook Ads Manager. Ayrshare handles all of the settings at the ad, ad set, and campaign levels. There is never a need to manually edit any of the settings directly in the Facebook Ads Manager.

  1. The Ads capabilites require the paid Ads add-on which can be enabled on the Account page of the web dashboard.
  2. The user must have linked a payment method at Facebook (Meta) prior to creating an ad.
  3. User Profiles like with a Facebook Page prior to April 1, 2025 should be re-linked to enable ads.

​
Create an Ad Flow

Boosting a post on Facebook is a quick and simple way to turn one of your existing posts into an ad. Here is a high-level flow of how to implement it in your platform:

1

Choose the Facebook Ad Account

Your user will choose the Facebook ad account which has all the billing details already configured.

Get Facebook Ad Accounts

2

Select the Post

Select a post from your Facebook page. It can be a photo, video, status update, etc.

Tip: Posts with good organic engagement (likes, shares, comments) tend to perform better when boosted.

3

Click “Boost Post”

Your user will click a button such as “Boost Post” in your platform to start setting up the ad.

Boost a post by submitting it to Facebook's ad platform

4

Set the Goal, Audience, Budget, & Duration

The user can set a number of parameters.

  • Choose the goal strategy for this boosted post by selecting a goal.

  • Customize the audience based on age, gender, location, interests, etc.
  • Choose how much to spend total.
  • Set the time period to run the ad.
5

Review & Boost

Double-check all the settings. If everything looks good, the user will click a button such as “Boost Post Now” button.

6

Ad Review & Launch

Facebook will review the ad — this usually takes anywhere from a few minutes to a few hours. Once approved, the boosted post goes live and runs according to the setup.

7

Track Spend & Performance

Monitor the following:

  • Reach
  • Engagement
  • Clicks
  • Spend
  • Budget Remaining

Get Facebook Ad Spend & Analytics

​
Ads API Best Practices

  1. Budget Management: Start with small test budgets (e.g., $5-10/day) to optimize performance before scaling.
  2. Ad Duration: Facebook requires a minimum ad runtime of 30 hours between start and end times.
  3. Interest Targeting: Choose 2-5 relevant interests for optimal targeting precision.
  4. Creative Guidelines: Use high-quality images and concise messaging to improve engagement rates.
  5. Performance Monitoring: Regularly check your ad performance and adjust targeting or creative elements as needed.

For detailed information about each endpoint, including request parameters, response formats, and examples, please refer to the individual API endpoint documentation pages.