API Reference

Winning creative, programmatically.

Create projects, generate creatives and request Winner Score predictions from your own systems with a clean REST API.

Free forever plan · No credit card · Live in under a minute

Lumen Skin
Sponsored
Winner
Glass skin in 14 days
The serum dermatologists keep recommending.
Winner Score
Predicted top performer
92
Shop now
REST
Predictable JSON endpoints
Bearer
Simple API key auth
Scale+
Plans with API access
9
Platforms supported
Authentication

One key. Every endpoint.

Generate an API key in Settings → API on the Scale plan or above. Send it as "Authorization: Bearer <key>". Keys are shown once and can be rotated at any time.

  • 01Keys are scoped to your workspace
  • 02Rotate or revoke instantly from Settings
  • 03All requests and responses use JSON over HTTPS
What you get

Everything you need to launch winners

Projects

Create a project from a URL or description and retrieve its analyzed product details.

Generate

Request creatives for a project with platform, format, count and tone.

Predict

Submit creatives and receive Winner Scores, predicted metrics and win probabilities.

Creatives

List, update, approve and archive creatives.

Campaigns

Create campaigns and queue creatives for publishing.

Credits

Check your remaining credits before large jobs.

How it works

From idea to proven ad in minutes

  1. 1

    Upgrade to Scale

    API access is included on Scale and Enterprise.

  2. 2

    Create a key

    Generate it in Settings and store it securely.

  3. 3

    Make requests

    Call endpoints with your bearer key.

Responses

Clean, predictable JSON.

Every response is a JSON object. Errors return an "error" message with a standard HTTP status code.

  • 401 for missing or invalid keys
  • 402 when credits are exhausted
  • 429 when rate limits are reached
Kindred Coffee
Sponsored
Test
Your new ritual, roasted Monday
Winner Score
Needs a sharper hook
67
Try free
Lumen Skin
Sponsored
Winner
Glass skin in 14 days
Winner Score
Predicted top performer
92
Shop now
Northpeak
Sponsored
Strong
Built for the 5am run
Winner Score
Above benchmark
81
Get yours
Use cases

Built for the way you grow

Catalog automation

Generate ads for every new product as it's added to your store.

Internal tools

Bring Winner Score into your own review workflow.

Agency platforms

Produce creative for many clients from your own dashboard.

Scheduled refreshes

Generate fresh variants on a schedule to fight ad fatigue.

The difference

Automation without the plumbing

The old way
  • Manual creative production for every SKU
  • Copy-paste between systems
  • No programmatic quality check
With AdCreator
  • Creatives generated on demand
  • Direct integration with your stack
  • Scores attached to every output
FAQ

Questions, answered

Which plans include the API?

Scale and Enterprise. Requests consume credits exactly like the app.

Are there rate limits?

Yes, generous per-key limits apply. Enterprise customers can request higher limits.

Can I revoke a key?

Yes — regenerate it in Settings and the old key stops working immediately.

Do you train on my brand or my ads?

Your brand assets, products and creatives stay private to your workspace. You can export or delete them at any time from Settings.

Can I cancel anytime?

Yes. Monthly plans can be cancelled in one click from Billing, and you keep access until the end of your current period.

Build something brilliant.

Talk to us about API access or upgrade to Scale today.

Talk to us