How it works
How it worksPricing
Start free trial
menu_bookProduct Documentation

How to use Xoru for organic customer acquisition

Step-by-step guides, feature deep dives, and growth playbooks. Learn how to track buyer conversations across Reddit, X, LinkedIn, and Hacker News, reply in your exact founder voice, and build compounding search visibility.

Monitored Channels:
Reddit
Twitter / X
LinkedIn
Hacker News
Product Hunt
Bluesky
Mastodon
Quora
Threads
Indie Hackers
Stack Overflow
GitHub
YouTube
format_list_bulletedDocumentation Index
26 sections
Step 01/settings
Calibrate Brand Voice & Positioning
Step 02/conversations/sources
Configure Monitored Channels & Lookback
Step 03/conversations
Discover Real-Time Buyer Intent & Sentiment
Step 04/conversations
Review, Refine, and Post Yourself
Settings Guide/settings
Settings Page: Tab-by-Tab Configuration
Conversations Guide/conversations
Conversations: Opportunities vs Mentions (Tags & Buttons)
Sources Guide/conversations/sources
Opportunity Sources: Tabbed Architecture & Channels
Feature 01/outreach
High-Intent 1-on-1 Outreach
Feature 02/create
SaaS Content Creator Studio
Feature 03/report
Free Live Lead Scanner & Reports
Feature 04/mcp
Model Context Protocol (MCP) Integration
Developers & Agents/settings?tab=api
Data Access API: Read and Write Your Xoru Data Over JSON
Feature 05/analytics
Analytics Hub
Feature 06/tools
Free Community & Scale Tools Hub
Playbook 01/analytics
Acquiring Your First 100 SaaS Users (Zero Ad Spend)
Playbook 02/conversations/sources
Competitor Complaint Interception
/analytics/analytics
Analytics: Home & Performance
/dashboard/analytics
Dashboard: Legacy Redirect
/conversations/conversations
Conversations: Social Listening Engine
/outreach/outreach
Outreach: Prospect Queue
/create/create
Create: SaaS Content Studio
/settings/settings
Settings: Brand Kit & Positioning Vectors
/report/report
Report: Free Live Lead Scanner
/mcp/mcp
MCP: Model Context Protocol Server
/tools/tools
Tools: Free Scale & Community Suite
/partners/partners/dashboard
Partners: Affiliate & Referral Program
Step 01/settings
Open in App

Calibrate Brand Voice & Positioning

Train Xoru on what you build, who you serve, and how you speak. The AI uses this context to draft authentic replies instead of generic marketing copy.

https://xoru.app/settings
Xoru Settings Brand Kit Tab
fullscreenView Fullscreen Lightbox

Settings - Brand Kit Tab

Brand Kit: Product Profile, Target Audience, and Positioning Vectors

What to configure

  • Add your website URL and core product pitch.
  • Define your target persona (e.g. bootstrapped founders, technical leads).
  • Fill in your 90-day growth goal so reply drafts focus on your current milestone.
  • Tune your Positioning Vectors: Core Value Vector, Status Quo Enemy, and Leverage Mechanism.

Why this matters

  • Prevents generic AI phrasing that gets flagged by Reddit moderators.
  • Ensures every response sounds like you wrote it from scratch.
  • Allows the model to cite specific advantages without hard-selling.

Tip: Use plain, conversational language in your settings. If you sound formal here, your AI drafts will sound formal online.

Step 02/conversations/sources
Open in App

Configure Monitored Channels & Lookback

Select the subreddits, keywords, and discussion platforms where your potential customers hang out.

https://xoru.app/conversations/sources
Xoru Sources summary view
fullscreenView Fullscreen Lightbox

Manage Sources Configuration

Tabbed navigation (Opportunities vs Mentions), lookback filters, and scan frequency

Two dedicated source tabs

  • Opportunities Tab: Configure problem search queries, high-intent subreddits, and platform lookback windows to find active buyers.
  • Mentions Tab: Track your brand name and competitor handles to capture complaints and switching opportunities.
  • 13 Monitored Channels: Reddit, X (Twitter), LinkedIn, Hacker News, Product Hunt, Bluesky, Mastodon, Quora, Threads, Indie Hackers, Stack Overflow, GitHub, and YouTube.
  • Custom Platform Lookback: Set independent lookback hours (e.g. 24h for fast-moving platforms, 48h to 7 days for developer forums).

Alert triggers & automation

  • Toggle email notifications for high-priority discussions.
  • Connect Slack or Discord webhooks on Growth and Scale plans for instant team alerts.
  • View past automated and manual scan logs in the Scanning History table.

Tip: Start with 5 to 10 narrow, targeted sources rather than 50 broad ones. Niche subreddits often deliver higher conversion rates.

Step 03/conversations
Open in App

Discover Real-Time Buyer Intent & Sentiment

Review fresh conversations scored by buying readiness, problem relevance, and brand sentiment.

https://xoru.app/conversations
Xoru Live Conversations feed
fullscreenView Fullscreen Lightbox

Live Buyer Opportunities Feed

Live buyer signals with relevance scoring, sentiment analysis, and instant drafting

Understanding the signals

  • Relevance Score (1-10): Calculated based on problem fit, urgency, and audience match.
  • Intent Badge: Identifies Buy Intent, Competitor Complaint, or Recommendation Request.
  • Sentiment Badge: Real-time sentiment classification (Positive, Neutral, Negative, Urgent / Churn Risk) on brand and competitor mentions.
  • Highlighted Search Terms: Matched keywords and problem terms are highlighted directly in the thread snippet for rapid triage.
  • Metrics & Age Indicator: Shows active upvotes, comments, and the exact time of the last metrics check (e.g. "Checked 5m ago").
  • Safety Gauge: Confirms whether you can mention your product directly or if a helpful answer without links is safer.

Managing the feed

  • Click "View summary" to quickly read thread context.
  • Click "View draft" to inspect the AI-generated reply.
  • Use "Skip" or "Replied" to keep your pipeline clean and organized.

Tip: Pay close attention to threads marked "Can mention product". For threads without it, answer the question helpfully first. Let users check your profile naturally.

Step 04/conversations
Open in App

Review, Refine, and Post Yourself

Xoru never auto-posts on your behalf. You inspect every draft, make edits, and post manually. This guarantees zero ban risk.

https://xoru.app/analytics
Xoru Analytics with recent buyer opportunities
fullscreenView Fullscreen Lightbox

Analytics: Review Workflow

Review or customize context-aware drafts before posting

The human-in-the-loop workflow

  • Click "Reply" to expand the AI-generated draft.
  • Review the draft against community norms and adjust any phrasing.
  • Copy the reply text with one click.
  • Click the external link to jump straight to the exact thread on Reddit, X, or LinkedIn.
  • Paste, publish, and mark the conversation as complete in Xoru.

Smart inactivity protection

  • Auto-Pause on Inactivity: Background automated scans pause if you are inactive for over 14 days to preserve quota.
  • Instant Auto-Resume: Logging back in automatically re-enables scanning with zero configuration.
  • Zero Ban Risk: Pure human-reviewed posting complies 100% with Reddit and platform rules.

Tip: Add a personal detail or reference from your own experience before posting. That personal touch transforms a good draft into an authentic answer.

Settings Guide/settings
Open in App

Settings Page: Tab-by-Tab Configuration

The Settings page is the central command center for your brand voice, distribution rules, platform accounts, developer access, and billing credentials. Below is what each tab controls.

https://xoru.app/settings
Settings Tab 1: Brand Kit
fullscreenView Fullscreen Lightbox

Settings Tab 1: Brand Kit

Tab 1: Brand Kit - Founder profile, product pitch, and Positioning Vectors

https://xoru.app/settings
Settings Tab 2: Distribution
fullscreenView Fullscreen Lightbox

Settings Tab 2: Distribution

Tab 2: Distribution - Schedule cadence, writing voice samples, and link preferences

https://xoru.app/settings
Settings Tab 3: Social Accounts
fullscreenView Fullscreen Lightbox

Settings Tab 3: Social Accounts

Tab 3: Social Accounts - Reddit, X, and Hacker News connected identities

https://xoru.app/settings
Settings Account tab
fullscreenView Fullscreen Lightbox

Settings Account Tab

Account tab - Credentials, subscription management, GDPR rights, and workspace

Tab 1: Brand Kit

  • Founder Name & Product Name: Personalizes reply sign-offs and context.
  • Website / Domain & Stage: Distinguishes pre-launch projects from live or growth-stage tools.
  • Target Audience / ICP: Identifies who you are talking to (e.g. solo founders, engineering leads).
  • Value Proposition (500 chars): Clear explanation of the transformation your product provides.
  • Core Problem & 90-Day Goal: Sets the concrete objective behind every conversation.
  • Positioning Vectors: Core Value Vector, Status Quo / Legacy Enemy, and Radical Leverage Mechanism.

Tab 2: Distribution

  • Success & Friction Factors: What channels have worked vs what has felt like a waste of time.
  • Voice Examples: Paste genuine text snippets you wrote yourself. Never submit robotic copy.
  • Writing Style: Set to "Direct and no-fluff" to guarantee punchy, human sentences.
  • Link Preference: "No Link Preference (mention product by name, omitting raw URLs)" vs "Own domain link".
  • Notification Timing: Timezone configuration and daily update delivery time.

Tab 3: Social Accounts

  • Reddit Account: Monitors account karma, age, and platform standing to prevent AutoMod removals.
  • X (Twitter) Profile: Tracks tweet velocity, audience reach, and algorithm tier with tailored reply strategies.
  • Hacker News Profile: Connects username for Show HN, Ask HN, and karma-informed discussion tone.

Tab 4: Integrations

  • Slack Webhook: Create an Incoming Webhook for a channel such as #growth or #opportunities, paste the URL, then send a test message before you rely on it.
  • Discord Webhook: Route the same alerts into a Discord channel using the same paste, test, and save flow.
  • What Gets Pushed: New high-intent opportunities plus brand and competitor mentions, delivered on your plan refresh cadence (30 minutes on Scale, hourly on Growth).
  • Plan Gating: Webhook routing is available on Growth and Scale. Starter accounts see the upgrade prompt instead.

Tab 5: API & MCP

  • Data Access API: Create scoped keys for scripts, dashboards, internal tools, and AI agents.
  • Scope Control: Give each key only the access it needs: read scopes for opportunities, brand mentions, competitor mentions, topics, engagement, and reports, plus write scopes for reply drafts, opportunity updates, saved mentions, and on-demand scans.
  • One-Time Secret: The full key is shown once. Only a SHA-256 hash is stored, so save it in a secret manager.
  • Usage & Activity: See per-key request counts, last-used timestamps, and recent API activity for your account.
  • MCP Connection: Reuse the same key to connect Claude Desktop, Claude Code, Cursor, or ChatGPT through the Xoru MCP server.
  • Revocation: Revoke a key at any time without affecting your other scripts, dashboards, or agents.

Tab 6: Account & Security

  • Auth Credentials: Login email and password reset management.
  • Onboarding Tour: Click "Replay tour" anytime to review the 5-step dashboard walkthrough.
  • Subscription & Entitlements: View active plan tier (Starter, Growth, Scale) and access customer billing portal.
  • GDPR & Privacy Rights: Manage cookie tracking, access privacy documentation, or request permanent data deletion.

Settings Tip: Spend 5 minutes filling out all three Positioning Vectors in the Brand Kit tab. When your Status Quo Enemy is clearly defined, your replies write themselves. Later, use the API & MCP tab to give a script or agent its own scoped key.

Conversations Guide/conversations
Open in App

Conversations: Opportunities vs Mentions (Tags & Buttons)

The Conversations page separates active buying intent from brand monitoring. Below is an exact breakdown of both lenses, what each tag means, and what every button executes.

https://xoru.app/conversations
Conversations: Opportunities Lens
fullscreenView Fullscreen Lightbox

Conversations: Opportunities Lens

Opportunities Lens: Active buying signals, relevance scores, and instant AI draft generation

https://xoru.app/conversations?lens=mentions
Conversations: Mentions Lens
fullscreenView Fullscreen Lightbox

Conversations: Mentions Lens

Mentions Lens: Brand and competitor name tracking, sentiment scoring, and 7-day trend chart

label

Tag Reference & What They Mean

Buy Intent

The thread author is asking for software or tooling recommendations. Highest lead priority.

Competitor Complaint

The author is unhappy with a competitor. Perfect opportunity to introduce a focused alternative.

Can mention product

Thread rules and context allow direct product mentions. Safe to include your product name.

Omit product link

Strict community rules or low thread age. Reply with value only; do not paste raw URLs.

Relevance Score (1-10)

Calculated match rating based on problem overlap, buyer intent, and audience alignment.

Sentiment (Pos / Neu / Neg / Urgent)

AI sentiment classifier flags customer praise, neutral commentary, or urgent competitor complaints.

smart_button

Button Actions & What They Do

“View draft”

Expands the AI-generated reply tailored to your founder voice and positioning vectors.

“Reply”

Opens the in-app response editor to customize phrasing and copy the reviewed text.

“Show full post”

Expands the entire original discussion post without having to leave Xoru.

“View summary”

Generates a condensed 2-sentence summary of the original author discussion.

“Skip”

Archives the conversation immediately, removing it from your active opportunity queue.

“Replied”

Marks the lead as completed and logs it into your workflow history.

“Open / View Thread”

Direct external link to open the exact thread on Reddit, X, or LinkedIn in a new browser tab.

“Scan now”

Triggers an immediate, on-demand scan across all active sources.

Opportunities Lens vs Mentions Lens

  • Opportunities Lens: Displays threads where founders and buyers are actively asking for software, tool recommendations, or troubleshooting a pain point your product solves.
  • Mentions Lens: Tracks occurrences of your brand name and monitored competitor names (e.g. Brand24, Octolens, Syften, GummySearch).
  • Mentions Sentiment & Analytics: Real-time sentiment classification (Positive, Neutral, Negative, Urgent / Churn Risk) with competitor complaint alerts and 7-day volume trends.
  • Active & Archive Lenses: Active displays threads you are currently monitoring; Archive stores skipped or completed discussions.
  • Keyword Highlighting: Matched search terms are highlighted in discussion snippets for rapid scanning.
  • Live Metrics Age: Displays exact time since upvotes, comments, and visibility were last synchronized (e.g. "Checked 5m ago").

Scanning Cadence & deco Mascot

  • Automatic Refresh widget shows exact hours between scans, last refresh timestamp, and next scheduled run.
  • Click "Scan now" for an immediate on-demand sweep across all connected platforms.
  • Deco Mascot: Provides helpful tips and encouragement as your distribution compounds.

Workflow Rule: Focus on threads with a Relevance Score of 8 or higher. If a thread is marked "Omit product link", explain how to solve the problem step-by-step. Let readers check your profile on their own.

Sources Guide/conversations/sources
Open in App

Opportunity Sources: Tabbed Architecture & Channels

The Sources page controls where Xoru listens, what keywords trigger alerts, how far back scans look, and where alerts are delivered. Features two dedicated tabs for Opportunities and Mentions.

https://xoru.app/conversations/sources
Xoru Opportunity Sources Full Page
fullscreenView Fullscreen Lightbox

Opportunity Sources: Tabbed Architecture

Sources page tabbed architecture: separate Opportunities and Mentions controls across 14 channels

account_tree

Opportunity Sources: Section-by-Section Guide

1. Tabbed Navigation (Opportunities vs Mentions)

Easily toggle between buyer intent discovery and brand/competitor monitoring.

Included Controls & Settings:
  • Opportunities tab: Search queries, problem phrases, and community channels.
  • Mentions tab: Brand terms, competitor tracking, and industry discussion topics.
  • Dedicated term counters and match volume totals per tab.

2. Monitored Channels & Platform Toggles

Enable or disable specific social platforms based on where your audience discusses software.

Included Controls & Settings:
  • Reddit, X (Twitter), LinkedIn, Hacker News, Product Hunt, Bluesky, Mastodon, Quora, Threads, Indie Hackers, Stack Overflow, GitHub, and YouTube.
  • Individual switches to pause platforms without deleting keywords.

3. Tracked Brand Terms & Competitor Interception

Direct keyword matching for brand mentions and competitor switching intent.

Included Controls & Settings:
  • Brand Terms: Monitors positive reviews, questions, and support mentions.
  • Competitor Terms: Tracks users complaining about rival software or asking for alternatives.
  • Negative sentiment prioritization filter for competitor terms.

4. Target Communities & Subreddits

Curated list of niche discussion forums where your ICP asks for advice.

Included Controls & Settings:
  • Default high-intent subreddits (r/SaaS, r/Entrepreneur, r/webdev, r/startups, etc.).
  • Add custom subreddit button to track micro-communities.

5. Platform Lookback Hours & Quality Thresholds

Configure sensitivity and lookback parameters to balance freshness and volume.

Included Controls & Settings:
  • Customizable platform lookback: 24 hours, 48 hours, or 7 days configured per platform.
  • Minimum relevance threshold: Filters out low-signal chatter below your desired match score.
  • Mention alerts toggle: Delivers real-time notifications (throttled to 1 per term per 15 minutes).

6. Notification Delivery Channels

Route alerts directly to where you and your team work.

Included Controls & Settings:
  • Email alerts: Standard on all subscription plans.
  • Slack & Discord webhooks: Instant notification routing available on Growth and Scale plans.

7. Scanning History & Audit Trail

Transparent log of every scan executed by Xoru.

Included Controls & Settings:
  • Timestamp of every run.
  • Sources scanned count and total items evaluated.
  • Leads found counter.
  • Trigger attribution: Auto (automated background cron) vs Manual (user triggered).

Architecture Overview & Tabs

  • Opportunities Tab: Configure search terms, buyer intent queries, targeted subreddits, and platform lookback hours to discover warm leads.
  • Mentions Tab: Track brand terms, competitor names (with negative sentiment prioritization), and broad topics with sentiment triggers.
  • Active Source Counter: Shows real-time count against plan limits (e.g. 17 / 20 active sources) and estimated daily throughput (~255 posts/day).
  • 13 Monitored Channels: Reddit, X (Twitter), LinkedIn, Hacker News, Product Hunt, Bluesky, Mastodon, Quora, Threads, Indie Hackers, Stack Overflow, GitHub, and YouTube.
  • Platform-Specific Lookback: Independently customize scan depth (24 hours, 48 hours, or up to 7 days) per social network.

FAQ: Why are generated keywords not relevant?

  • Source keywords and subreddits are generated directly from your Brand Kit product details in Settings.
  • If suggested keywords feel off-target or broad, your product profile might be wrong, incomplete, or outdated.
  • Go to Settings (/settings) -> Brand Kit and refine your Product Name, Core Pitch, and Positioning Vectors.
  • Once updated, return to Sources to recalibrate your monitored search terms with precise buying intent.

Sources Starter Tip: Review your Scanning History table weekly. If you notice a scan found zero leads, expand your platform lookback window to 48 hours or add 2 to 3 adjacent subreddits.

Feature 01/outreach
Open in App

High-Intent 1-on-1 Outreach

Identify individual founders and operators actively describing acute pain points. Reach out directly on LinkedIn or X with personalized, contextual private messages.

https://xoru.app/outreach
Xoru Outreach Queue
fullscreenView Fullscreen Lightbox

High-Intent Outreach Queue

Contextual outreach candidates with LinkedIn, X, and email drafts

Targeted Prospect Discovery

  • Discovers individual users who posted about struggles your tool solves.
  • Displays a clear "WHY REACH OUT" rationale explaining the exact context and angle.
  • Generates a personalized, friendly direct message draft that feels personal, not canned.

Safe Direct Outreach

  • Click "Open LinkedIn" or "Open X" to copy the draft and jump straight to the profile.
  • When a published email is found, generate a subject and email draft, then open it in your email client.
  • Mark candidate as "Done" or "Skip" to keep your prospect queue focused.

Plan Availability

  • Included on Growth (up to 150 outreach leads/mo, 5/day) and Scale (up to 300 outreach leads/mo, 10/day).
  • Not included on Starter. Starter sees a blurred sample queue with an upgrade path.

Outreach Tip: Keep cold DMs brief. Ask an insightful question about their specific project instead of pitching a demo link right away.

Feature 02/create
Open in App

SaaS Content Creator Studio

Draft high-impact posts for Twitter/X, Reddit, and LinkedIn tailored to your specific audience and positioning vectors.

https://xoru.app/create
Xoru Create Content studio
fullscreenView Fullscreen Lightbox

SaaS Content Creator Studio

Platform-tailored drafts, writing guides, and recent creation history

Studio Features

  • Target Channel Selection: Optimize length, tone, and formatting for X, Reddit, or LinkedIn.
  • Goal Configuration: Set objectives like "Get app visits", "Build brand awareness", or "Start conversations".
  • Writing Guides & Tips: Built-in tactical advice on concrete hooks and platform-specific tone.
  • Draft History: Access all your past generated posts and variations whenever you need inspiration.

Creator Tip: Use the "Start conversations" goal when writing for Reddit. Ask open-ended questions at the end of your post to drive discussion.

Feature 03/report
Open in App

Free Live Lead Scanner & Reports

Scan any public SaaS domain or product description to preview real-time customer opportunities across Reddit, X, Bluesky, and Mastodon.

https://xoru.app/report
Xoru Free Enriched B2B Lead Generator
fullscreenView Fullscreen Lightbox

Free Live Lead Scanner

Public lead generator to test social listening for any domain or product

https://xoru.app/report/8aKZtL32dqi
Xoru Sample Generated Lead Report
fullscreenView Fullscreen Lightbox

Interactive Sample Enriched B2B Lead Report

Interactive enriched B2B lead report showing discovered discussions, author profiles, CSV export, and AI draft previews

Public Scanner Features

  • Domain Input: Enter any website URL to automatically extract value props, search keywords, and site branding.
  • Product Description Mode: Describe your product manually if you have not launched a landing page yet.
  • Multi-Network Search: Evaluates real-time opportunities across Reddit, Twitter/X, Bluesky, and Mastodon.
  • One-Click CSV Export: Download full scan datasets, thread URLs, and opportunity scores for offline lead qualification.
  • Shareable Link: Share your permanent report URL with teammates or co-founders.

Scanner Tip: Run your competitors’ URLs through the scanner to see what discussions their potential buyers are having right now.

Feature 04/mcp
Open in App

Model Context Protocol (MCP) Integration

Connect Cursor, Claude Desktop, and Windsurf AI coding assistants directly to Xoru’s live social listening and opportunity stream.

https://xoru.app/mcp
Xoru MCP Integration & Opportunity Stream
fullscreenView Fullscreen Lightbox

Model Context Protocol Integration

Stream real-time buyer conversations and social listening signals directly into your AI IDE

AI Agent Native Social Listening

  • Seamless MCP Server: Exposes Xoru search tools, brand listener triggers, and opportunity queues to AI agents.
  • Compatible with Cursor, Claude Desktop, Windsurf, and custom agent workflows.
  • Enables your AI pair programmer to research community pain points and buyer feedback during development.
  • One-click JSON configuration block available at /mcp.

MCP Tip: Add Xoru to your Claude Desktop config to ask "What are the latest complaints about our competitors?" without leaving your desktop.

Developers & Agents/settings?tab=api
Open in App

Data Access API: Read and Write Your Xoru Data Over JSON

A scoped REST API for scripts, dashboards, internal tools, and AI agents. Read opportunities, mentions, topics, engagement, and reports. Generate reply drafts, mark opportunities done, save mentions, and start an on-demand scan. Every paid plan includes access. Keys are scoped, revocable, and tied to your account.

Resources you can read

  • Opportunities from your monitored sources, with relevance scores and source context.
  • Brand mentions and competitor mentions, separated by role and filterable by sentiment.
  • Tracked topics and their scan sources, so agents know what is being monitored.
  • Engagements with the latest metric snapshot, without private task bodies.
  • Weekly reports with task counts and feedback summaries.
  • Account identity and key metadata at /api/v1/me.

Actions you can take

  • Generate a reply draft with POST /api/v1/opportunities/:id/reply. The draft is saved to the opportunity and its version history.
  • Mark an opportunity done with POST /api/v1/opportunities/:id/done. The completion time is recorded and repeat calls are idempotent.
  • Save a brand or competitor mention with POST /api/v1/mentions/:id/save. The mention is marked as seen and the save time is recorded.
  • Run a scan now with POST /api/v1/scans. It uses one scan from your monthly plan allowance, respects the same scan interval and source checks as the app, and returns a summary. Fetch the new opportunities from GET /api/v1/opportunities afterwards.
  • Write actions count toward the same per-minute and monthly request limits as reads.

Authentication and scopes

  • Create a key in Settings > API & MCP. The secret is shown once, then stored as a SHA-256 hash.
  • Send the secret as Authorization: Bearer xoru_live_... on every request.
  • Each key carries only the scopes you select: read scopes for opportunities, brand mentions, competitor mentions, topics, engagement, and reports, plus write scopes for reply drafts, opportunity updates, saved mentions, and on-demand scans.
  • The account is resolved from the key. There is no account ID parameter to spoof.
  • Revoke a key at any time. Expired, revoked, and malformed keys all return the same 401 error.

Pagination, limits, and errors

  • Use limit and offset on list endpoints. limit defaults to 25 and caps at 100.
  • Use since with an ISO-8601 timestamp to fetch only newer rows.
  • Per-minute limits are enforced per key. Monthly quotas are enforced across the account and reset on the first day of each UTC month.
  • Every response includes RateLimit-* and X-Api-Quota-* headers. A 429 includes Retry-After.
  • Errors return a stable JSON code such as invalid_api_key, insufficient_scope, not_found, invalid_status, reply_draft_limit_reached, scan_limit_reached, scan_rate_limited, rate_limited, monthly_quota_exceeded, or response_too_large.
curl examples · 12 endpoints
GET /api/v1/meAccount identity, key metadata, and granted scopes.
curl "https://xoru.app/api/v1/me" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/opportunitiesBuyer-intent conversations discovered for your account.
curl "https://xoru.app/api/v1/opportunities?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/brand-mentionsMentions of your own brand and product.
curl "https://xoru.app/api/v1/brand-mentions?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/competitor-mentionsMentions of the competitors you track.
curl "https://xoru.app/api/v1/competitor-mentions?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/topicsYour monitoring terms, keywords, and scan sources.
curl "https://xoru.app/api/v1/topics?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/engagementTracked replies, reach, and visibility metrics.
curl "https://xoru.app/api/v1/engagement?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
GET /api/v1/ranking-threadsGoogle Page 1 threads discovered for your tracked keywords.
curl "https://xoru.app/api/v1/ranking-threads?limit=25&offset=0" \
  -H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/opportunities/:id/replyGenerate and save a reply draft for an opportunity.
curl -X POST "https://xoru.app/api/v1/opportunities/OPPORTUNITY_ID/reply" \
  -H "Authorization: Bearer xoru_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"link_preference":"none"}'
POST /api/v1/opportunities/:id/doneMark an opportunity done and record the completion time.
curl -X POST "https://xoru.app/api/v1/opportunities/OPPORTUNITY_ID/done" \
  -H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/mentions/:id/saveSave a brand or competitor mention for follow up.
curl -X POST "https://xoru.app/api/v1/mentions/MENTION_ID/save" \
  -H "Authorization: Bearer xoru_live_your_key"
POST /api/v1/scansRun an on-demand scan and return the scan summary.
curl -X POST "https://xoru.app/api/v1/scans" \
  -H "Authorization: Bearer xoru_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"lens":"opportunities"}'
POST /api/v1/ranking-threads/:id/statusUpdate the status of one ranking thread.
curl -X POST "https://xoru.app/api/v1/ranking-threads/RANKING_THREAD_ID/status" \
  -H "Authorization: Bearer xoru_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"status":"done"}'

Plan limits for the Data Access API

PlanRequests / minRequests / monthActive keys
Starter6025,0002
Growth120100,0005
Scale300500,00010
Custom600+Custom25+

Agent tip: Give an agent its own key with only the scopes it needs. Write scopes can generate drafts and change status, so grant them deliberately and revoke the key when the task is done.

Feature 05/analytics
Open in App

Analytics Hub

Performance tracking across mentions, brand vs competitor sentiment, the opportunity funnel, and reply performance.

Decoupled Analytics Modules

  • Overview KPIs: mentions found, noise filtered, and plan usage.
  • Sentiment: brand and competitor net sentiment over time, with gaps where a bucket has too few mentions.
  • Opportunity Funnel: matches found, reply rate, reply performance, and channel activity.

Analytics Tip: Check the Opportunities tab weekly. A rising reply rate means your search terms are matching threads you can actually answer.

Feature 06/tools
Open in App

Free Community & Scale Tools Hub

Standalone, zero-cost utility tools for SaaS founders: analyze Reddit accounts, discover high-intent keywords, and verify reply tones.

https://xoru.app/tools
Xoru Free Tools Suite
fullscreenView Fullscreen Lightbox

Free Tools Hub

Explore free standalone tools to supercharge your organic distribution stack

Three Specialized Utilities

  • Reddit Account Analyzer (/tools/reddit-account-analyzer): Audit any Reddit username for karma, account age, and moderation risk.
  • Reddit Keyword Finder (/tools/reddit-keyword-finder): Identify high-traffic problem phrases across relevant developer and founder communities.
  • Reply Tone Checker (/tools/reply-tone-checker): Verify that your draft replies sound conversational and helpful before hitting publish.

Tools Tip: Run your Reddit profile through the Account Analyzer before posting in high-moderation subreddits to verify your karma standing.

Playbook 01/analytics
Open in App

Acquiring Your First 100 SaaS Users (Zero Ad Spend)

A practical 15-minute daily workflow for solo founders to get early paying customers through organic community discussions.

https://xoru.app/analytics
Xoru Analytics workflow for daily distribution
fullscreenView Fullscreen Lightbox

Daily 15-Minute Distribution Routine

Daily analytics routine: review top opportunities, post replies, and track results

The Daily 15-Minute Routine

  • Minute 01-03: Open Xoru Analytics. Review the morning notification batch.
  • Minute 04-09: Filter for 2 to 3 high-relevance buyer opportunities (Score 8+).
  • Minute 10-13: Review the AI draft, add a short personal anecdote, copy, and post natively.
  • Minute 14-15: Log the replies in Engagements to track upvotes and responses.

Why this works

  • Targets warm leads who are already searching for a solution today.
  • Zero ad budget required.
  • Compounds over time as older answers continue bringing in organic referral visits.

Rule: Never paste generic affiliate links. If a subreddit forbids promo links, just describe the workflow. Interested founders will naturally check your bio.

Playbook 02/conversations/sources
Open in App

Competitor Complaint Interception

Find customers who are frustrated with expensive or complex legacy tools and offer an authentic, helpful alternative.

https://xoru.app/conversations/sources
Monitoring competitor terms in Xoru Sources
fullscreenView Fullscreen Lightbox

Competitor Interception Setup

Add competitor brand terms to discover switching and alternative discussions

Execution Steps

  • Add key competitor brand names in your Sources keywords.
  • Look for phrases like "alternative to [Competitor]", "[Competitor] is too expensive", or "[Competitor] broke".
  • When replying, validate their frustration genuinely before introducing your tool.
  • Highlight your specific leverage angle (e.g. human-reviewed safety vs spam bots).

Integrity Rule: Never trash competitors dishonestly. Acknowledge what they do well, then clearly explain where your focused tool differs.

/analytics/analytics
Open in App

Analytics: Home & Performance

Central authenticated home view with mentions, brand vs competitor sentiment, and the Opportunity Funnel. Legacy /dashboard redirects here.

Available Actions

  • Review mentions, noise filtered, and plan usage.
  • Compare your brand against the top two competitors over time.
  • Track the opportunity funnel, reply rate, and reply performance.
  • Toggle timeframe metrics: 7-day, 30-day, 90-day, and all-time.
/dashboard/analytics
Open in App

Dashboard: Legacy Redirect

Legacy root dashboard route. Automatically and seamlessly redirects to /analytics.

https://xoru.app/dashboard
Xoru Analytics
fullscreenView Fullscreen Lightbox

Analytics Route View (Legacy Redirect)

Analytics overview with instant opportunities

Available Actions

  • Automatic 308 redirect to /analytics for full performance reporting.
  • Preserves all authentication sessions and deep links.
/conversations/conversations
Open in App

Conversations: Social Listening Engine

Live feed of buyer intent discussions detected across monitored channels.

https://xoru.app/conversations
Xoru Conversations
fullscreenView Fullscreen Lightbox

Conversations Route View

Real-time buyer discussions with intent ratings and voice-matched drafts

Available Actions

  • Filter by status (Opportunities, Mentions, Active, Archive).
  • Read AI thread summaries and generate customized drafts.
  • Skip or mark opportunities as used.
  • Trigger manual instant scans on demand.
/outreach/outreach
Open in App

Outreach: Prospect Queue

Personalized outreach to founders and prospects on LinkedIn and X, with optional email drafts when a published address is found.

https://xoru.app/outreach
Xoru Outreach
fullscreenView Fullscreen Lightbox

Outreach Route View

Individual founder prospects with contextual message generation

Available Actions

  • Review "Why Reach Out" rationale.
  • Generate contextual LinkedIn, X, or email drafts.
  • One-click routing to the prospect profile or email client.
  • Manage prospect status (Done or Skip).
/create/create
Open in App

Create: SaaS Content Studio

Generate platform-tailored posts for X, Reddit, and LinkedIn with writing guidance.

https://xoru.app/create
Xoru Content Studio
fullscreenView Fullscreen Lightbox

Create Content Route View

Platform-optimized content creator with strategic writing advice

Available Actions

  • Select platform: X (Twitter), Reddit, or LinkedIn.
  • Choose objective: visits, awareness, conversations, or SEO.
  • Review recent draft creations and prompt history.
  • Follow channel-specific writing tips and format rules.
/settings/settings
Open in App

Settings: Brand Kit & Positioning Vectors

Configure product pitch, ICP, 90-day targets, and core positioning vectors.

https://xoru.app/settings
Xoru Settings Brand Kit Tab
fullscreenView Fullscreen Lightbox

Settings Route View

Calibrate the AI co-pilot with your exact product parameters

Available Actions

  • Update product pitch and value proposition.
  • Configure 90-day growth goals.
  • Set Positioning Vectors (Core Value, Status Quo Enemy, Leverage Mechanism).
  • Manage subscription plan and billing details.
/report/report
Open in App

Report: Free Live Lead Scanner

Public tool to scan any domain or product pitch for live customer opportunities.

https://xoru.app/report
Xoru Free Lead Scanner
fullscreenView Fullscreen Lightbox

Report Route View

Public lead scanner for any website domain or product brief

Available Actions

  • Scan website URL for active opportunities.
  • Describe a product manually before launching a domain.
  • Generate shareable live report URLs.
  • Preview voice-matched reply drafts on real threads.
/mcp/mcp
Open in App

MCP: Model Context Protocol Server

Documentation and integration guide to connect Claude Desktop, Cursor, and Windsurf directly to Xoru.

https://xoru.app/mcp
Xoru Model Context Protocol (MCP)
fullscreenView Fullscreen Lightbox

MCP Server Route View

Model Context Protocol instructions and ready-to-paste JSON config blocks

Available Actions

  • Copy one-click MCP client configuration for Cursor or Claude Desktop.
  • Test live social listening tools in your IDE agent environment.
  • Access authenticated opportunity search endpoints via stdio/SSE.
/tools/tools
Open in App

Tools: Free Scale & Community Suite

Directory of free standalone tools: Reddit Account Analyzer, Reddit Keyword Finder, and Reply Tone Checker.

https://xoru.app/tools
Xoru Tools Suite Hub
fullscreenView Fullscreen Lightbox

Tools Suite Route View

Free community intelligence and audit tools for bootstrapped SaaS founders

Available Actions

  • Analyze any Reddit profile for karma health and spam filter risk.
  • Extract high-volume buying keywords from targeted developer communities.
  • Validate AI drafts with the Reply Tone Checker to guarantee ban safety.
/partners/partners/dashboard
Open in App

Partners: Affiliate & Referral Program

Track referral performance, monthly recurring commissions, and partner payouts.

https://xoru.app/partners/dashboard
Xoru app overview
fullscreenView Fullscreen Lightbox

Partners Program Route View

Xoru analytics overview

Available Actions

  • Generate and customize unique partner referral links.
  • Monitor referral visits, trial signups, and paid subscriber conversions.
  • Configure automated monthly payouts through Stripe or PayPal.
Xoru

Find the conversations where buyers are already asking.

Xoru on PeerPushFeatured on CodeHypeFazier badge
Review onG2
Read reviews
Product
Open AppHow it worksPricingFAQFree ReportDocumentationAPI & MCPChangelogHire a specialist
Solutions
For FoundersFor Marketing TeamsAI Social ListeningReddit Lead GenTwitter / X Lead GenSaaS Lead GenerationGet Cited by ChatGPT & PerplexityLinkedIn Intent
Resources & Free Tools
Free Tools HubCompetitor Mention AuditIntent Keyword ScannerEnriched B2B Lead GeneratorReddit Keyword FinderReply Tone ValidatorAlternatives & ComparisonsBlogPlaybooksCustomer StoriesCase StudiesG2 Reviews
Company
About UsContactReferral ProgramPrivacy PolicyTerms of Service
ASK AI ABOUT XORU

© 2026 Xoru. All rights reserved.