docs

How to use Looper HQ

Looper HQ is a marketing operating system. It builds your site, finds leads, runs sequences, generates ads, schedules social, takes calls, watches competitors, and tells you when to act — all under one credit balance.

Get started in 5 minutes

Sign in at /login. New tenants start with 100 trial credits, free.
Run the /onboarding wizard. It picks a recommended subset of features for your business — you can always come back and add more later.
Pick a paid plan on /pricing when you're ready: Starter $29 / Pro $79 / Business $249. Each plan includes a monthly credit grant that covers everything below.

What you can do — by layer

Every feature charges credits at a published rate. You see the credit cost on every paid action button before you click.

Foundations

/brand-kit — Brand kit. Logo gen, colors, fonts. Every site/ad/email inherits this.
/brand-voices — Brand voice. Auto-detected from your site, customer reviews, sales transcripts.
/sites — Sites. AI-generated landing pages + multi-page sites, deployed to Vercel under your custom domain.
/widgets — Chat widget. Embed on any site. Logged conversations, cost-gated.
/forms — Forms. Embeddable forms, autoresponders, webhooks.

Sales engine

/leads/discover — Lead discovery. Google Places, Apollo, GitHub, web research. Smart classifier picks the source.
/leads — Leads + CRM. Contacts, scoring, lifecycle stages, deal pipeline, activity feed.
/sequences — Email sequences. Multi-step outreach with personalization. Resend or BYOK Gmail.
/voice — Voice agents. Twilio incoming + outgoing IVR with LLM-driven dialog.
/leads/agents — Booking agents. Auto-prospect + auto-book meetings into your calendar.
/missions — Missions. Long-running multi-tool agents. Plan-then-approve mode for big spend.

Marketing engine

/ads — Ad copy. Meta + Google Ads variants, character-limited, brand-voiced.
/ad-audiences — Ad audiences. Sync CRM segments to Meta + Google Customer Match.
/social — Social scheduler. Schedule + auto-publish across platforms via Ayrshare.
/recipes — Recipes. Pre-built workflow templates: welcome series, re-engagement, etc.
/legal — Legal docs + contracts. Privacy policy, terms, MSAs auto-drafted in your voice.
/images — Image gen. FAL FLUX (logos, hero), OpenAI gpt-image-1 (text-on-image).
/uploads — Video uploads. Gemini Files API for transcript + analysis.

Intelligence layer

/aeo — AEO citation tracker. Daily checks across ChatGPT, Perplexity, Claude, Gemini, Sonar. Auto-rewriter for pages losing citations.
/competitors — Competitor watchlist. Daily diff cron on competitor URLs. High-significance changes spawn counter-campaign drafts.
/ad-intel — Competitor ad library. Pull Meta Ad Library entries for any FB advertiser. Free public source.
/seo — SEO research. Keyword ideas, SERP rank tracker, backlinks via your own DataForSEO key. Optional Similarweb passthrough.
/benchmarks — Industry benchmarks. Anonymized P25/P50/P75/P90/mean for 7 metrics across all Looper tenants in your industry.
/insights — Cross-source insights. Fuses AEO + competitor + SEO + CRM data into "act on this" moments.

Agency + admin

/agency — Agency dashboard. Every Looper HQ tenant you have access to in one table. Switch with 1 click.
/computer-use — Computer-use agent. Drive a real browser via Browserbase to do tasks no API exposes.
/apps — Custom apps builder. Generate internal SaaS — tables, pages, blocks — from a prompt.
/marketplace/apps — App marketplace. Publish + sell your custom apps. 80/20 creator split via Stripe Connect.
/integrations — Integrations. BYOK keys for Anthropic, OpenAI, Gemini, Perplexity, Apify, Hunter, DataForSEO, Similarweb, Twilio, Stripe, Google.
/security — Security + audit log. Per-tenant access controls, audit trail, HIPAA tier scaffold, GDPR self-serve.

Pricing + billing

One credit = $0.01 retail. Plans grant credits monthly; you can also buy credit packs at any time. Every paid action shows the credit cost before you click.

Free — 100 trial credits one-time. No monthly grant.
Starter $29/mo — 2,000 credits/mo + every paid feature.
Pro $79/mo — 6,500 credits/mo + 1,000 signup bonus.
Business $249/mo — 20,000 credits/mo + 5,000 signup bonus.
Enterprise — custom contract, BYOK, dedicated support.

See /pricing for current tiers + feature breakdown, /settings/usage for the live ledger and /settings/credits for top-ups + plan changes.

BYOK — bring your own keys

BYOK is a Business + Enterprise feature. Free / Starter / Pro plans pay through the credit balance at retail; Business and above can connect their own provider keys at /integrations to bypass our markup for that provider. Your keys are stored AES-256-GCM encrypted with PBKDF2-derived per-tenant secrets.

Supported on eligible plans: Anthropic, OpenAI, Gemini, Perplexity, FAL, Apify, Hunter.io, People Data Labs, Tavily, ElevenLabs, Twilio, Stripe (Connect), Google (Gmail / Drive / Calendar / Sheets), DataForSEO, Similarweb, Browserbase.

When BYOK is enabled, calls bypass our credit charge and bill directly to your provider account. You still see the call in /settings/usage. Below Business tier, the keychain page shows an upgrade prompt.

Site analytics

Every site you deploy through Looper gets a first-party analytics tracker auto-injected. No GA, no client-side script you have to install. Visit /analytics or /sites/[id]/analytics for per-site breakdowns: live feed, top pages, traffic sources, GSC keywords, SEO lint score.

Computer-use agent

For tasks no API exposes — login portals, dashboards, data entry — Looper provisions a real Chrome session via Browserbase and drives it with Sonnet. Plans run in plan-then-approve mode; you see every step before billing continues. High-risk plans stay blocked from auto-execution.

See /computer-use. Browserbase costs ~$0.10/min wholesale; we charge a 50-credit floor + per-step LLM costs.

Settings + management

/dashboard — your home. What fired today, recent leads, pending sequences, AEO score, top KPIs.
/settings/usage — credit ledger. Every charge, every refund, every BYOK call.
/settings/team — invite collaborators, set roles (owner / admin / member / viewer).
/automations — kill switches for every cron + recurring routine. Toggle off if budget is tight.
/exports — download your data as CSV / JSON. GDPR-friendly.

Keyboard shortcuts

`⌘K / Ctrl+K`	Command palette — search across every route
`⌘Enter`	Submit on Compare, Ask the Web, AEO, most chat-style inputs
`J / K`	Next / previous on list views (queue, leads)
`?`	Show this list

Troubleshooting + FAQ

A button charged me but didn't return anything

Open /settings/usageand find the charge. If it's for an LLM call that returned malformed JSON, the rewriter and counter-campaign drafters now save a parse_failed record so you have an audit trail. Email support@looperhq.com with the charge ID for a refund if the output was truly empty.

My emails aren't reaching anyone except my own address

That's the Resend onboarding sender — works without setup but only delivers to the account owner's email. Verify a custom domain in your Resend dashboard and set DIGEST_FROM_EMAIL to the verified address. Contact support if you need help setting up DNS records.

DataForSEO / Similarweb says 'not connected'

BYOK-only by design. Sign up at the provider, copy your key, paste it at /integrations. Stored AES-256-GCM encrypted. We never see the plaintext.

Cost spike I didn't expect

Open /automations to toggle off recurring crons. Then /settings/usageto find the spike and identify which feature drove it. Every paid action has a confirmation dialog with the cost — if a charge happened without one, that's a bug; please report it.

Tenant switch / agency mode

Visit /agency. Lists every tenant you have access to (owner or member with accepted invite). Click a row to switch sessions in 1 click.

High-risk computer-use plan won't execute

That's by design. Plans rated 'high' risk (irreversible, sends messages, spends money, touches sensitive data) require a human to lower the risk rating manually before execution. We'd rather block one legitimate plan than let one malicious one run.

Found a gap in this doc? support@looperhq.com — we update this page on every release.