# ScaleForge

> ScaleForge is a Rails 8 SaaS platform for Meta Ads media buyers. It automates creation, management, and optimization of Meta Ads campaigns at scale — from bulk campaign uploads to auto-rules for bid management and pause/activate logic.

Domain: https://getscaleforge.com
Stack: Ruby on Rails 8, PostgreSQL 16, Redis 7, Solid Queue, Hotwire (Turbo + Stimulus), Tailwind CSS.
Primary product: ScaleMachine — turns one creative into dozens of Meta Ads campaigns across multiple ad accounts with varied bids, CBO/ABO strategies, and dynamic creative (multi-text) support.
Pricing: Free, Starter, Pro, Agency tiers, flat monthly pricing from $29/mo (no percentage of ad spend) — see /pricing.
Locales: en (default), uk, ru; blog also in pt (pt-BR).

## Products

- [ScaleMachine](https://getscaleforge.com/scalemachine): Bulk Meta Ads campaign creation. Single-account and multi-account uploads with inter-account delays. Supports CBO/ABO, dynamic creative (asset_feed_spec), multi-video formats, automatic Page-Backed Instagram Account (PBIA) provisioning, per-account Meta creative ID caching, real-time progress via Turbo Streams, CSV export.
- [Analytics](https://getscaleforge.com/features): Dual-source analytics combining Meta Ads Insights and RedTrack conversion data. Hourly and daily aggregation with timezone-aware bucketing. Live updates via ActionCable (in-app feature; overview on /features).
- [Auto-Rules](https://getscaleforge.com/features): Automation engine for bid management, pause/activate logic. Reads from combined daily stats; executes via Meta Batch API (up to 50 operations per request); logs RuleExecution; sends Telegram notifications (in-app feature; overview on /features).
- [Fan Pages](https://getscaleforge.com/features): Meta Page management with AI-generated posts and per-Page ad-limit monitoring (Meta caps at 250 running/in-review ads per Page; ScaleForge warns at 85%, blocks at 92%) (in-app feature; overview on /features).
- [Watchlist](https://getscaleforge.com/extension/adspy): Tracking of competitor ads via Facebook Ads Library scans — part of the Chrome extension flow ([Facebook Ads Library Scraper on Chrome Web Store](https://chromewebstore.google.com/detail/facebook-ads-library-scra/hcfmddiidcahnpifnmpcpmgdjbgpcinb)).
- Hunter Mode (beta): Voice uniqueification pipeline — download video, transcribe (Gemini), translate, regenerate voice (ElevenLabs), merge (in-app feature).
- HookForge (beta): Video hook replacement that preserves original on-screen text overlays using FFmpeg + ImageMagick (in-app feature).

## Public REST API

Base URL: https://getscaleforge.com/api/v1/
Auth: Bearer token. Users issue long-lived API tokens via the dashboard, or exchange a Firebase ID token at `POST /api/v1/auth/firebase` (used by the Chrome extension).
Format: JSON request, JSON response.
Versioning: URL-based (`/api/v1/`).

OpenAPI spec (machine-readable): https://getscaleforge.com/api-docs/v1/swagger.yaml
Interactive Swagger UI: https://getscaleforge.com/api-docs/

Rate limits per plan:
- Free: 100 requests/hour, 10/minute
- Starter: 500/hour, 30/minute
- Pro: 1000/hour, 60/minute
- Agency: 5000/hour, 200/minute

Endpoints (all under `/api/v1`):
- `GET  /ad_accounts` — list user's Meta ad accounts
- `GET  /ad_accounts/:id` — show single account
- `GET  /ad_accounts/:id/ads_volume` — Meta ads-volume check (page ads limit)
- `GET|POST|DELETE /creatives` — list, upload, delete creatives
- `GET|POST|PATCH|DELETE /templates` — campaign templates (targeting, bidding, placements)
- `GET|POST /uploads` — bulk upload sessions; `POST /uploads/:id/{pause,resume,cancel}`
- `GET /campaigns`, `POST /campaigns/{activate,pause,update_bids}`, `GET /campaigns/active_last_30_days`
- `GET /analytics`, `GET /analytics/summary`
- `GET|POST|PATCH|DELETE /rule_sets`, `POST /rule_sets/:id/execute`
- `GET|POST|PATCH|DELETE /posts`, `POST /posts/:id/publish` — Meta Page posts (AI-generated)
- `GET|POST|DELETE /webhook_subscriptions` — Chrome-extension webhooks
- `GET|POST|DELETE /hunted_creatives` — Hunter Mode results
- `GET|POST|DELETE /watchlist`, plus `/watchlist/:id/scans` and `/watchlist/:id/ads`
- `GET|POST|DELETE /tokens` — API-token self-management
- `POST /auth/firebase` — exchange Firebase ID token for ScaleForge API token

## Integrations

- Meta Marketing API v24.0 — campaigns, ad sets, creatives, ads, videos, images, PBIA.
- Meta Conversions API — server-side pixel events (purchase, lead).
- Meta Batch API — up to 50 operations per request for bulk bid changes and state transitions.
- Firebase Auth + Firestore — Chrome extension auth and data storage.
- Stripe — USD subscription checkout and webhooks.
- WayForPay — UAH subscription checkout (Ukraine market).
- RedTrack — conversion attribution, revenue data.
- Google Gemini — transcription, translation, AI content generation (posts, creative analysis).
- ElevenLabs — text-to-speech voice generation.
- Telegram Bot API — auto-rule notifications.
- Resend — transactional email delivery.

## Use cases for AI agents

ScaleForge's public API is designed for automation agents that need to:
- Launch Meta Ads campaigns programmatically at scale from templates and creative libraries.
- Monitor cross-account performance (CPL, ROAS, CPC, spend) with unified Meta + RedTrack attribution.
- Apply conditional automation: pause underperforming adsets, scale bids on profitable creatives, promote top-performing campaigns.
- Track Meta Page ad limits before launching, to avoid rejections from the 250-ads-per-Page cap.
- Scrape and classify competitor creatives from the Meta Ad Library (Watchlist).
- Manage Page-Backed Instagram Accounts (PBIA) without manual Ads Manager interaction.

## Blog

- [Blog](https://getscaleforge.com/blog): Guides and playbooks on Meta Ads automation, bulk campaign launching, Facebook Ads Library research, and tracker integrations. Available in English, Ukrainian, Russian, and Portuguese (pt-BR at /pt/blog). RSS: https://getscaleforge.com/blog.rss

## Public pages

- [Home](https://getscaleforge.com/): Platform overview.
- [Pricing](https://getscaleforge.com/pricing): Plans, limits, feature matrix.
- [Features](https://getscaleforge.com/features): Feature breakdown.
- [ScaleMachine](https://getscaleforge.com/scalemachine): Primary product landing page.
- [FAQ](https://getscaleforge.com/faq): Common questions.
- [Terms of Service](https://getscaleforge.com/terms)
- [Privacy Policy](https://getscaleforge.com/privacy)
- [Health check](https://getscaleforge.com/up): Liveness endpoint.

## Contact

- Email: michael@getscaleforge.com

## Optional

- [Chrome Extension Landing](https://getscaleforge.com/extension/adspy): AdSpy extension overview and checkout flow.
- [Extension Pricing](https://getscaleforge.com/extension/adspy/pricing): Standalone plans for the Chrome extension.
- Webhooks: Stripe at `POST /webhooks/stripe`, WayForPay at `POST /webhooks/wayforpay`.
- ActionCable channel: `AnalyticsChannel` — per-user streaming of analytics updates (requires session auth).