Everything you need to
go from sign-up to viral.
cowral helps you understand your niche, monitor your social accounts, follow trends by region, and turn those trends into content ideas and scripts. This guide walks through the app one step at a time.
Create your account
Sign up, verify your email, and finish a short onboarding.
02Connect an account
Add a YouTube, TikTok, or Instagram profile to sync your metrics.
03Generate ideas
Turn live trends into ranked, trend-aware content ideas and scripts.
Step 01 · Get started
Create your account #
Sign up with your email address and a password. As soon as you register, cowral emails you a 6-digit verification code.
Enter that code in the app to verify your account. You need to verify your email before you can fully use cowral.
Prefer Google? If the Google button is shown on the sign-in screen, you can sign up or sign in with your Google account instead.
Step 02 · Get started
Complete onboarding #
After your email is verified, a short onboarding helps cowral personalize everything you see. You'll be asked for details such as:
- Your niche or content category
- Your bio
- Your content goal
- Your country (optional)
- Your name or username
- Your platform (optional)
- Your profile URL (optional)
Platform and profile URL are optional — you can skip connecting an account here and add one later from Social Accounts.
Your niche matters most. It drives dashboard personalization, trend filtering, and the context used to generate ideas and scripts.
Step 03 · Core features
Connect social accounts #
You can connect creator accounts from YouTube, TikTok, and Instagram. When you add an account, cowral looks up the profile and saves details including:
- Profile name and username
- Bio and profile image
- Follower or subscriber count
- Post or video count, where available
You can refresh a connected account at any time to pull its latest metrics. Each refresh also records a new snapshot, which feeds your growth chart.
Step 04 · Core features
Use the dashboard #
The dashboard shows performance and profile information for the selected social account. If you've connected more than one, use the account selector to switch between them.
Depending on the account, the dashboard can show:
- Account profile summary
- Follower or subscriber count
- Total views, where available
- Content count and niche
- Growth chart
- Benchmark creators
- Sync status
The dashboard loads from your saved account data rather than calling the provider every time, so it opens faster once an account has been synced. The growth chart needs at least two snapshots before it can plot a line — refresh an account a second time if it shows a placeholder.
Step 05 · Core features
Use the Trends Feed #
The Trends Feed helps you find trending content signals. Filter by platform, region, and niche.
Platforms
- X
- TikTok
- News
Regions
- US
- UK
- Canada
- Australia
- All regions
Niches
Business, Health, Lifestyle, Relationship, Entertainment, Sport, AI, Politics, and Technology.
If the feed looks empty, use the refresh button. Refresh pulls fresh trend data, saves it, and reloads the feed. News can return more items than X or TikTok because cowral combines multiple news providers.
Step 06 · Core features
Generate content ideas #
Use the AI Content Editor to generate content ideas built from:
- Your niche or category
- The selected platform
- The selected region
- The selected trend context
cowral generates several ideas at once and saves them automatically — there's no separate save step.
Starter plans have a daily generation limit. Pro and Agency plans have higher or unlimited access depending on your active plan.
Step 07 · Core features
Generate scripts #
Once you've chosen an idea or topic, you can generate a full script. You can provide:
- A topic or idea title
- A direction or angle
- The platform
- The niche or category
cowral writes the script and saves it automatically, ready to copy into your editor or scheduler.
Step 08 · Account & billing
Plans & billing #
cowral has three plans. Upgrade any time — the app sends you to Stripe Checkout, and your plan updates automatically once payment goes through.
Starter
$0 /mo
- 1 social account
- 3 generations per day
- Basic trends feed
Pro
$19 /mo
- Unlimited ideas & rewrites
- Up to 5 social accounts
- Live personalized trends
- Full success dashboard
Agency
$79 /mo
- Unlimited everything
- Unlimited social accounts
- For teams & agencies
- Contact-sales flow
You can open the billing portal from the app whenever it's available to manage your subscription details. If a Starter account goes over its daily limit, generation is paused until the next daily reset or an upgrade.
Step 09 · Account & billing
Manage your account #
From account settings you can:
- View your account details
- Manage connected social accounts
- Remove a connected social account
- Delete your cowral account
Deleting your account removes your user profile and related saved data. This can't be undone.
Help · Common fixes
Troubleshooting #
Email verification isn't working
Request a new code, then check your spam folder if it still doesn't arrive.
The Trends Feed is empty
Try changing the region, platform, or category, then press refresh to pull fresh data.
Dashboard data looks out of date
Refresh the connected social account, then reload the dashboard to see the latest metrics.
Generation says I've hit a limit
Check your plan, or wait until the next daily reset. Upgrading to Pro or Agency lifts the Starter limit.
Developers · REST API
API reference #
Building on cowral? The REST API lives under the base path /api/v1. Most endpoints require a bearer token.
Authorization: Bearer <access_token>Authentication
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /auth/register | Create a user and send a verification code |
| POST | /auth/verify-email | Verify the 6-digit email code |
| POST | /auth/resend-verification | Resend a verification code |
| POST | /auth/login | Exchange identifier + password for a token |
| POST | /auth/google | Sign in with a Google ID token |
| POST | /auth/forgot-password | Send a password-reset email |
| POST | /auth/reset-password | Set a new password with a reset token |
Users & onboarding
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /users/me | Current user, incl. onboarding_completed |
| POST | /users/onboarding | Save niche, bio, goal and profile details |
| DELETE | /users/me | Delete the account and related data |
Social accounts & dashboard
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /social-accounts | List connected accounts |
| POST | /social-accounts | Add an account (youtube · tiktok · instagram) |
| POST | /social-accounts/{id}/refresh | Refresh metrics and record a snapshot |
| DELETE | /social-accounts/{id} | Remove a connected account |
| GET | /dashboard/accounts/{id} | Dashboard data for one account |
Trends
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /trends/{tiktok|x|news} | Read saved trends from the database |
| POST | /trends/{tiktok|x|news}/refresh | Fetch fresh trends from providers |
Content & billing
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /content/ideas/generate | Generate and save trend-aware ideas |
| POST | /content/scripts/generate | Generate and save a script |
| GET | /billing/me | Current subscription status |
| POST | /billing/checkout-session | Start a Stripe Checkout session |
| POST | /billing/portal-session | Open the Stripe billing portal |
Ideas and scripts are saved on generation — there are no separate "save" calls. If a Starter user is over the daily quota, the generate endpoints return 402 Payment Required.