Viewpoint Docs

Status: Live product documentation Source of truth: current iOS app implementation in Viewpoint-Frontend Audience: first-time users deciding whether to download and use Viewpoint

1) What Viewpoint Is

Viewpoint is an iOS app that fact-checks short-form social videos in seconds.

Paste or share a video URL from TikTok, Instagram Reels, YouTube Shorts, X (Twitter), Facebook, or Snapchat, and Viewpoint returns:

• A Truth Score (0-100)
• A clear verdict
• Claim-by-claim checks with source links
• AI reasoning for each claim
• Influence tactic detection
• Visual frame analysis on Deep checks

The app is already live, and this documentation reflects the live product behavior.

2) How It Works

1. Share a video to Viewpoint (or paste the link in the app).
2. Viewpoint analyzes transcript and metadata, then streams progress.
3. You receive a report with score, verdict, claims, and evidence.

Typical completion time is about 15-45 seconds depending on video length and analysis depth.

3) Supported Platforms

Viewpoint currently supports links shared from only short form content on these platforms:

• TikTok
• Instagram Reels
• YouTube Shorts
• X (Twitter)
• Facebook
• Snapchat

4) Analysis Types

Basic Check

• Transcript-first analysis
• Checks 3 claims and surfaces 30 sources
• Uses Basic credits

Deep Check

• Full analysis with transcript + visual frame analysis
• Checks 5 claims and surfaces 50 sources
• Uses Deep credits

5) What You See in a Result

Each result report includes:

• Truth Score ring (0-100)
• Verdict label
• Summary
• Claims list with per-claim status and confidence
• Evidence sources for each claim
• Influence tactics section (when detected)
• Video keyframe analysis section (Deep checks)

Claim statuses are grouped for readability:

• Supported / mostly true
• Mixed / mostly false
• Refuted
• Opinion / unverified (when applicable at claim level)

6) Verdict System

Current app verdict values:

• True
• Mostly True
• Mixed
• Mostly False
• False
• Unverifiable

Score color scale:

• 70-100: green
• 40-69: orange
• 0-39: red

7) Share Extension and Notifications

Viewpoint includes an iOS share extension.

Default behavior:

• Share video -> Viewpoint submits analysis -> extension auto-dismisses
• You get notified when the result is ready
• Tapping the notification deep-links to the report

If notifications are not authorized:

• The app can still work
• Users may need to return manually to view completed analyses

Notification policy in onboarding copy:

• One notification per completed fact-check
• No ads or daily spam prompts

8) Account, Privacy, and Sync

• Sign in method: Sign in with Apple
• Sign in with Apple is required to complete onboarding and use the full app flow
• No password flow is required
• Credits and history sync across devices after sign in
• JWT auth token is stored securely in Keychain on device

Privacy statement used in product copy:

• Video content is analyzed server-side to produce the fact-check report
• Product copy should use a short plain-English privacy summary and link to full policy
• Full policy links: https://veiwpoint.tech/privacy and https://veiwpoint.tech/tos

9) Credits and Purchases

Viewpoint uses two credit buckets:

• Deep credits
• Basic credits

Credit behavior:

• Purchased credits do not expire
• New users start with one-time free starter credits
• Conversion is supported (2 Basic <-> 1 Deep) and other way around

In-app purchasable packs currently map to:

• Basic: $1.99 -> 5 Deep + 15 Basic
• Skeptic: $4.99 -> 45 Deep + 15 Basic
• Investigator: $9.99 -> 110 Deep + 40 Basic
• Fact-Checker: $19.99 -> 300 Deep + 100 Basic

Users can buy credits from onboarding and Settings and can restore purchases.

10) Community, Streaks, and Reward Loops

Viewpoint includes community surfaces and streak mechanics in the live product for engagement and retention.

Community surfaces

• Trending checks
• Viral fake / misleading checks
• Mystery Check content

Streak and retention mechanics

• Daily streak progression with timezone-aware logic
• Streak calendar view
• Longest streak tracking
• Freeze prompts and freeze windows
• Milestone rewards can be shown in-product when triggered

Important launch note

• Do not market any reward loop as a guaranteed public offer unless it is explicitly enabled and approved for launch copy.

11) Instant Results, Web Viewing, and Shareable Links

Why results are sometimes instant

Viewpoint can return a completed result immediately when a compatible stored analysis already exists.

There are two instant-return paths:

• Personal replay: you already checked that exact URL before. Returned instantly, no new analysis run, and no extra credit charge for that replay path.
• Global cache hit: another matching stored analysis already exists. Returned instantly, but credit can still be charged for first-time access for that user.

If there is no compatible stored result, Viewpoint runs a fresh pipeline and returns asynchronously.

Public web viewing

• Each completed analysis has a permanent content ID
• Viewpoint exposes a public web-view payload for that content ID
• Shared links resolve to veiwpoint.tech/content-id style pages for web viewing

Sharing behavior

• iOS app can share result links externally
• Shared result links support web view flows and referral attribution flows
• Link sharing can also tie into reward mechanics and growth loops

12) Why Viewpoint Is Faster Than Manual Fact-Checking

Manual verification is usually slow because users must:

• Extract claims themselves
• Open many tabs
• Cross-check conflicting sources
• Judge credibility under time pressure

Viewpoint compresses this into one flow:

• Automatic claim extraction
• Multi-source retrieval and curation
• Claim-level scoring and verdict synthesis
• Structured output in one report

In practice, users often get results in seconds for cached content and in under a minute for fresh runs (depending on video length and depth).

13) Community Section (Trending, Viral, Mystery)

Viewpoint includes public community surfaces for discovery and engagement.

Current community concepts in product/backend:

• Trending checks: most-checked visual analyses
• Viral fake/misleading checks: ranked fake/misleading content feed
• Mystery Check: most-analyzed recent content teaser with claim flow

Community cards can include:

• Platform
• Summary
• Truth score and verdict
• Check count (how many times analyzed)
• Thumbnail/media when available

14) Streaks, Freeze, and Retention Loops

Viewpoint includes a full streak system, not just a counter.

Streak behavior highlights:

• Daily streak progression with timezone-aware logic
• Streak calendar view for recent activity days
• Longest streak tracking
• At-risk detection and freeze prompts

Freeze behavior:

• Users can spend Basic credits to protect an active streak window
• Freeze cost scales by usage
• Freeze availability and status are calculated server-side

Reward behavior tied to streak/cache activity:

• Milestone rewards can grant bonus credits
• Cache-hit activity can contribute to gift mechanics
• Push notifications can announce streak risk and reward events

15) History and Search

• Every completed analysis is stored in history
• History can sync from backend when signed in
• Search is available in History
• Popular/trending slices can be surfaced from stored analyses
• Semantic search quality/features vary by available credits/tier state

16) Common Error States (User-Friendly)

User-facing language for known failures:

• Invalid link: The URL is not supported or malformed.
• Credits exhausted: Buy credits or use a share/reward path when available.
• Rate limited: Free check limit hit; try again later.
• Video unavailable: Source video was removed or is inaccessible.
• Auth expired: Sign in again.
• Temporary network issue: Retry.