Win & Scale

The Instagram ads API for code and agents.

Find the Instagram ads that pay, and launch the next one paused, from your own code. 80 REST operations, the same tools as MCP.

7 days free with every feature. Cancel anytime.

Works with

Win & Scale REST API · base URL
OpenAPI 3.1
https://winandscale.com/api/v1

What is the Instagram ads API?

Win & Scale is an Instagram ads API for your code. 80 REST operations under /api/v1 read your ad account and launch every ad paused. Instagram and Facebook are placements of one Meta ad account, so one connection covers both.

An ad from Vessa Row, a fictional brand, in a phone, with the agent's work around it: Values tagged (Staple blazer, Office-to-evening dresser), a winning creative, a launch built paused and a prompt waiting for the owner to activate it. Selfie-style ad for Vessa Row showing a woman in a black blazer in a fitting room with the caption Okay this blazer is the one.

MCP or API: which should I use?

Use the MCP server when an AI agent does the work. Use the REST API when your own code does. Both reach the same tools on the same ad account, under one approval grant, and a launch from either one is created paused.

Two ways in: the MCP server for an AI agent with 88 tools, and the REST API for your code with 80 operations.

What can your agent do on Instagram with Win & Scale?

Instagram placements from one connection. Each capability names the tool behind it, and the same tools reach Facebook.

  • Paused

    MCP + APICampaigns, ad sets and ads, created paused

    New or existing campaign and ad set, images and videos, every Advantage+ creative enhancement opted out. One 9x16 file runs in Instagram Stories and Reels, and a feed-ratio file covers Instagram Feed.

    meta_launch_ads · POST /launches

  • MCP + APIInsights, daily and lifetime

    A nightly warehouse of ad-level insights and each ad's lifetime history. Over MCP, live breakdowns show how Instagram Feed, Stories and Reels each spent, beside age and gender.

    meta_get_overview · GET /overview

  • MCP + APIAd Library search

    Search the Meta Ad Library by keyword or advertiser, then save the ads worth keeping to your swipe file.

    meta_search_ad_library · meta_save_swipe

  • MCP + APICreatives and video transcripts

    What each creative is, stored as Values: angle, persona, hook, format. Library videos are transcribed automatically.

    meta_tag_creatives · GET /creatives

  • MCP + APILead forms

    List and create instant forms on the Page behind your Instagram account, then send a test lead through the whole chain before an ad runs.

    meta_create_lead_form · POST /lead-forms

  • MCP + APITests with a frozen question

    Commit a Test before it runs, append what you observe, and record why it worked as a learning.

    meta_create_test · POST /tests

Why not call the Meta Marketing API directly?

You can. Here is what your agent has to handle on its own, and what Win & Scale handles for it.

  • Access

    Meta Marketing API, directly

    Facebook Login for Business needs a Meta app past App Review and Business Verification.

    With Win & Scale

    A System User token from your own Business Manager, entered once by an admin.

  • Token handling

    Meta Marketing API, directly

    Your code holds the token, and so does any agent you hand it to.

    With Win & Scale

    Encrypted in a table no client can read. It never travels over MCP or REST.

  • Drafts

    Meta Marketing API, directly

    There is no draft object. An ad is paused only if every call says PAUSED.

    With Win & Scale

    Every launch is created paused. Going live is a separate call that waits for approval.

  • Advantage+ creative

    Meta Marketing API, directly

    Enhancements left on can rewrite the copy you approved.

    With Win & Scale

    Every enhancement is opted out on every creative.

  • Rate limits

    Meta Marketing API, directly

    Hourly call quotas, reported in response headers, with throttling once you pass them.

    With Win & Scale

    Reports read a nightly warehouse, not Meta. meta_get_api_usage shows the quota left this hour.

  • Versions

    Meta Marketing API, directly

    Marketing API versions are retired on a schedule, and your calls move to the next one.

    With Win & Scale

    Graph and Marketing versions are pinned and upgraded by us.

  • For an agent

    Meta Marketing API, directly

    Raw endpoints to learn, and numbers with no context on how far to trust them.

    With Win & Scale

    88 described tools, and an evidence check that says which numbers to trust.

Where to go next

Questions, answered

Everything else is in the docs.

Is there an Instagram ads API for developers?
Yes, there is an Instagram ads API for developers. Win & Scale has a REST API at https://winandscale.com/api/v1 with 80 operations, and a launch through it buys Instagram and Facebook placements together.
Can an AI agent turn on spend by itself?
No, an AI agent can't turn on spend by itself. Win & Scale creates every campaign, ad set and ad paused, and meta_activate needs a person's approval.
Can my agent and my code share one ad account?
Yes, your agent and your code can share one ad account. The Win & Scale MCP server and REST API reach the same workspace and tools, so a launch from either one is created paused.
Can I run Instagram ads without Facebook?
Not as a separate choice today. A launch buys Instagram and Facebook placements together, or Meta's automatic placements, and the insights break the spend down by placement so you can see how Instagram did.
Do I need Meta App Review?
No, you don't need Meta App Review. Win & Scale connects with a System User token from your own Business Manager, which needs no App Review.
How much does Win & Scale cost?
Win & Scale has a 7-day free trial with every feature. After it, each ad account is a flat monthly price set by its ad spend: $49 up to $10k a month, up to $399 at $250k, custom above.

Connect your agent to Instagram ads.

Start a 7-day free trial with your website, mint an API key, and make a read-only call first.

Works with