Quick Start

GETTING STARTED

Get up and running with Uplytics.ai in under 5 minutes. Connect your social accounts and start seeing real analytics immediately.

Create Your Account

Head to uplytics.ai/signup and create your free account using email or Google OAuth.

Tip: The free plan includes 1 social account, basic analytics, and 1 report per month. No credit card required.

Connect Your Socials

After signing up, you'll be prompted to connect your Facebook Pages and/or Instagram Business accounts. This uses Meta's official OAuth flow — we never see your password.

Click "Connect Facebook" or "Connect Instagram" from your dashboard
Log in to your Meta account and select the pages/accounts to connect
Grant the requested permissions (read-only analytics access)
You'll be redirected back to Uplytics.ai with your data loading automatically

Note: Instagram accounts must be Business or Creator accounts linked to a Facebook Page. Personal accounts are not supported by Meta's API.

Explore Your Dashboard

Once connected, your dashboard will populate with real-time data including follower counts, engagement rates, reach, impressions, and recent post performance. Use the sidebar navigation to access Analytics, Demographics, Reports, AI Insights, and more.

Your First Report

Navigate to Reports in the sidebar, click "Generate New Report", select your date range and accounts, and Uplytics.ai will generate a branded 12-page PDF with executive summary, engagement analysis, demographics, competitor benchmarks, and AI recommendations.

Auth

AUTHENTICATION

Uplytics.ai supports multiple sign-in methods. All authentication is handled securely with JWT tokens.

Email & Password

Field	Requirements
Email	Valid email address, unique per account
Password	Minimum 8 characters
Name	Your display name

Google OAuth

Click "Continue with Google" on the login or signup page. Your Google credentials are never stored on our servers — authentication is handled entirely by Google's OAuth 2.0 flow. We only receive your name, email, and profile picture.

Meta OAuth (Connecting Socials)

Connecting Facebook and Instagram accounts uses a separate Meta OAuth flow. This grants Uplytics.ai read-only access to your analytics data. Permissions requested:

pages_show_list — View your Facebook Pages
pages_read_engagement — Read engagement data
instagram_basic — Read Instagram profile
instagram_manage_insights — Read Instagram analytics

You can revoke access at any time from your Uplytics.ai settings or from Meta's App Settings.

Features

DASHBOARD OVERVIEW

Your dashboard is the central hub for all your social media data. See everything at a glance.

Key Metrics

The dashboard overview displays your most important metrics in real-time:

Total Followers

Combined follower count across all connected accounts

Engagement Rate

Average engagement rate for the selected time period

Total Reach

Number of unique users who saw your content

Impressions

Total number of times your content was displayed

Profile Views

How many times your profile was visited

Website Clicks

Clicks to your website from social profiles

Date Range Selector

Use the date range picker in the top right of any analytics page to filter data. Presets include Last 7 days, Last 30 days, Last 90 days, and custom range. All charts and metrics update automatically when the range changes.

Platform Switcher

Toggle between Facebook and Instagram views using the platform switcher. You can also view combined metrics across both platforms for a unified view of your social presence.

Content

POSTS

Browse, filter, and analyze every piece of content you've published across Facebook and Instagram.

Posts Feed

The posts page displays all your published content in a scrollable feed with thumbnails, captions, engagement metrics (likes, comments, shares, saves), reach, and post type badges. Each post shows its platform of origin and publish date.

Filters & Sorting

Narrow down your content to find exactly what you need:

Platform — Facebook, Instagram, or All
Content type — Photo, Video, Reel, Carousel, Story
Date range — Filter by publish date
Sort by — Engagement, reach, date (newest/oldest), likes, comments

Post Details

Click any post to see its full analytics breakdown — including hourly engagement timeline, audience reach demographics, hashtag performance for that specific post, and how it compares to your account averages.

Deep Dive

ANALYTICS

Go beyond surface-level numbers. Uplytics.ai breaks down your performance across every dimension.

Engagement Metrics

Track likes, comments, shares, and saves across all your content. Uplytics.ai calculates your engagement rate as: (interactions / reach) × 100.

View engagement trends over time with interactive charts. Hover over any data point to see exact values and day-over-day change percentages.

Reach & Impressions

Reach measures unique users who saw your content. Impressions count total views including repeat views. Uplytics.ai charts both metrics side-by-side so you can understand content virality and how often your audience revisits your posts.

Follower Growth

Track net follower growth over time, broken down by follows and unfollows. Correlate growth spikes with specific posts or campaigns to understand what drives audience growth.

Content Type Analysis

See how different content formats perform for your audience:

Type	Tracked Metrics
Photos	Likes, comments, reach, saves
Videos	Views, watch time, likes, comments, shares
Carousels	Swipe-through rate, likes, saves
Reels	Plays, likes, comments, shares, reach
Stories	Views, replies, exits, taps forward/back

Audience

DEMOGRAPHICS

Understand who your audience is — their age, gender, location, and when they're most active.

Age & Gender

View your audience distribution across age brackets (13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+) split by gender. Interactive bar charts let you compare segments and identify your core demographic.

Countries & Cities

See the top countries and cities where your followers are located, ranked by follower count. Useful for planning geo-targeted content or identifying markets for expansion.

Language Breakdown

Know what languages your audience speaks. This helps you decide whether to create multi-language content or focus on your primary audience language.

Activity Heatmap

A 7×24 heatmap showing when your followers are most active online (day of week × hour of day). Use this to find the best posting windows for maximum reach and engagement.

Output

PDF REPORTS

Generate professional, client-ready branded PDF reports with a single click.

Generating a Report

Navigate to Reports in the sidebar
Click "Generate New Report"
Select the date range (default: last 30 days)
Choose which accounts to include
Click "Generate" — your PDF will be ready in seconds

Custom Branding

Upload your logo, set your brand colors, and customize the report header. Reports will use your branding throughout — perfect for white-labeling to clients. Configure branding in Settings → Report Branding.

Report Pages Breakdown

Each report includes 12 pages:

Cover Page — Your branding, report period, account details

Executive Summary — Key metrics at a glance with period-over-period comparison

Content Performance — Performance by content type with platform split

Content Summary — Post count by type, budget breakdown, publishing cadence

All Posts — Every post published with thumbnails, engagement, and reach

Top Posts Showcase — Top performing posts with images, captions, and detailed metrics

Demographics — Age, gender, location, language, and activity heatmap

Growth Trends — Follower growth and daily reach trends over time

Competitive Analysis — How you compare to tracked competitors

Hashtag Performance — Top and underperforming hashtags with trends

AI Recommendations — AI-generated insights and action items

Summary & Next Steps — Key wins, projections, and action items

Intelligence

AI INSIGHTS

Uplytics.ai uses AI to analyze your data and surface actionable recommendations.

Engagement Health Score

A score from 0-100 that evaluates your overall social media health based on engagement rate, growth trajectory, content consistency, and audience responsiveness. Scores are broken down into sub-categories so you know exactly what to improve.

Best Posting Times

AI analyzes your audience activity patterns and past post performance to recommend the optimal days and times to post for maximum engagement. Recommendations are updated weekly as new data comes in.

Content Recommendations

Based on your top-performing content and competitor analysis, AI generates specific recommendations: what content types to focus on, topics to explore, posting frequency adjustments, and hashtag strategies.

Trend Analysis

Identifies emerging trends in your niche based on competitor activity, hashtag velocity, and engagement pattern changes. Get ahead of trends instead of chasing them.

Create

CONTENT PLANNING

Let AI help you plan your content strategy with data-driven ideas, captions, and hashtags.

AI Content Ideas

Based on your top posts, competitor gaps, and trending formats in your niche, Uplytics.ai generates content ideas complete with format suggestions (reel, carousel, single image), topic angles, and expected engagement potential.

Caption Generation

AI writes captions in your brand voice based on your existing content tone. Each caption includes a hook, body text, call-to-action, and relevant emojis. Generate multiple variants and pick your favorite.

Hashtag Suggestions

Get a mix of high-volume and niche hashtags optimized for discovery. Uplytics.ai analyzes hashtag performance from your past posts and competitor content to suggest the most effective tags for each post.

Automate

SMART SCHEDULING

Plan and schedule your content across platforms with AI-optimized timing.

Optimal Slots

AI analyzes your audience's online activity and past post performance to suggest the best time slots for each day of the week. Slots are color-coded by expected engagement level (green = high, yellow = medium, gray = low).

Calendar View

See your scheduled, drafted, and published content in a monthly calendar view. Drag and drop posts to reschedule them. View by platform or see all platforms combined.

Draft & Review Workflow

Content goes through a simple workflow:

DraftReviewScheduledPublished

Intelligence

COMPETITOR ANALYSIS

Track your competitors and understand exactly where you're winning — and where you're not.

Adding Competitors

Add competitors by entering their Facebook Page or Instagram handle. Uplytics.ai pulls their public data including follower count, posting frequency, and engagement metrics. Pro plan supports 5 competitors; Enterprise supports 10+.

Engagement Comparison

Compare your engagement rate, follower growth, and posting frequency against each competitor in side-by-side charts. See where you outperform and where there's room for improvement.

Gap Analysis

Uplytics.ai identifies content gaps — topics or formats your competitors are succeeding with that you haven't tried yet. Also highlights your unique strengths that competitors aren't matching.

Account

SETTINGS & PROFILE

Manage your account, connected social accounts, report branding, and billing preferences.

Profile Management

Update your personal information from the Profile page:

Display name, email, and profile avatar
Agency or brand name (shown on reports)
Change password (for email-based accounts)
View linked login methods (Google, email)

Connected Accounts

View and manage your linked Facebook Pages and Instagram Business accounts. You can disconnect individual accounts at any time — cached data is purged within 24 hours. Reconnect to re-authorize if Meta permissions expire.

Report Branding

Customize the look of your PDF reports for white-label delivery:

Logo — Upload your agency or client logo (PNG, SVG)
Brand colors — Primary and accent colors for report headers and charts
Company name — Appears on the cover page and footer
Contact info — Optional website and email on the cover

Notifications

Configure email notifications for weekly performance digests, report completion alerts, significant engagement spikes or drops, and new AI insight availability. Toggle each category on or off from the Settings page.

Billing & Plans

Manage your subscription and view usage:

Free1 social account, basic analytics, 1 report/month

Pro5 social accounts, full analytics, unlimited reports, AI insights, 5 competitors

EnterpriseUnlimited accounts, API access, custom branding, 10+ competitors, priority support

Developers

API REFERENCE

Integrate Uplytics.ai data into your own tools and workflows with our REST API.

Authentication

All API requests require a JWT token passed in the Authorization header:

Authorization: Bearer <your-jwt-token>

Base URL: api.uplytics.ai

Endpoints

POST/auth/login— Authenticate and receive JWT

POST/auth/register— Create new account

GET/accounts— List connected social accounts

GET/analytics/overview— Dashboard overview metrics

GET/analytics/engagement— Engagement data over time

GET/demographics— Audience demographics

GET/posts— Post-level analytics

GET/demographics/follower-growth— Follower growth over time

POST/reports/generate— Generate new PDF report

GET/reports— List generated reports

GET/ai/insights— AI-generated insights

GET/ai/content-ideas— AI content planning ideas

GET/competitors— Competitor data

GET/schedule— Scheduled posts and optimal slots

GET/user/profile— Current user profile

PUT/user/profile— Update profile settings

Error Handling

All errors follow a consistent JSON format:

{
  "error": true,
  "message": "Description of the error",
  "code": "ERROR_CODE"
}

Status	Meaning
400	Invalid request parameters
401	Missing or invalid JWT token
403	Insufficient permissions or plan limits
404	Resource not found
429	Rate limit exceeded
500	Internal server error

Trust

SECURITY & PRIVACY

Your data security is our top priority. Here's how we protect your information.

Data Encryption

All OAuth access tokens are encrypted at rest using AES-256 encryption. All connections use TLS 1.3. API keys and sensitive credentials are stored in Cloudflare KV with encryption at rest enabled.

Data Handling

Social media data is cached for up to 24 hours to reduce API calls
Cache is refreshed on your next visit after expiry
When you disconnect an account, all cached data is deleted within 24 hours
Generated reports are stored in Cloudflare R2 and accessible only to your account
We never sell, rent, or share your data with third parties

NEED MORE HELP?

Can't find what you need? Our team typically responds within 24 hours.