Skip to main content

​
Intelligence reports

The /v1/report endpoint analyzes comment data and produces a structured audience intelligence report. Think of it as hiring an analyst to read every comment and tell you what your audience is thinking, who the key players are, and what to do next.

​
What you get

Every report includes 8 sections (Basic) or 10 sections (Pro):
SectionWhat it tells you
Executive SummaryKey metrics + the one strategic insight that matters
Audience ClustersWho your commenters are, grouped by behavior and sentiment
Narrative MapThe dominant stories your audience is telling, with trajectory
Sentiment BreakdownPositive/negative/neutral distribution with pattern analysis
Top 10 Influence LeadersMost influential commenters ranked by likes, not frequency
Spam DetectionCoordinated bot campaigns, fake engagement, promotional spam
Recommendations6 specific, data-backed actions to take
Channel HealthScorecard across 6 health signals
Repeat Commenters (Pro)Superfan detection and loyalty patterns
Content Brief (Pro)3 episode concepts + engagement playbook

​
Use cases

​
Agency white-labeling

Generate reports for your clients’ channels. Each report costs 0.50−0.50-1.50 via API. Bill your clients whatever you want. The markdown output makes it easy to render in your own branded template. 
for client in clients:
    comments = fetch_youtube_comments(client.channel_id)
    report = nawa.report(
        comments=comments,
        tier="pro",
        title=f"{client.name} Weekly Report",
        channel_context=client.description
    )
    send_to_client(client.email, report.data.report_markdown)

​
SaaS integration

Embed audience intelligence into your analytics dashboard. Use the sections object for structured data instead of parsing markdown. 
const { data } = await nawa.report({ comments, tier: "pro" });

// Render each section in your UI
dashboard.renderClusters(data.sections.clusters);
dashboard.renderSentiment(data.sections.sentiment);
dashboard.renderRecommendations(data.sections.recommendations);

​
Weekly automated digest

Run a cron job that pulls your latest video’s comments and generates a report every Monday morning. 
import schedule

def weekly_report():
    comments = youtube.get_latest_video_comments(limit=200)
    report = nawa.report(
        comments=[{"text": c.text, "author": c.author, "likes": c.likes} for c in comments],
        tier="basic",
        title="Weekly Channel Report"
    )
    slack.post(channel="#content-strategy", text=report.data.report_markdown)

schedule.every().monday.at("08:00").do(weekly_report)

​
Tips for best results

  1. More comments = better clusters. 10 is the minimum, but 50-200 gives much richer analysis.
  2. Include likes data. The influence leader ranking uses likes, not comment count. Without likes, ranking falls back to comment length.
  3. Set channel_context. Telling the AI your channel niche (e.g., “tech review channel, 500K subscribers”) produces more relevant recommendations.
  4. Use Pro for client-facing reports. The Content Brief and Repeat Commenter sections are what agencies charge for.
  5. Parse sections, not markdown. The sections object gives you pre-parsed text for each report section. Use it for structured rendering instead of regex-parsing the markdown.

​
Pricing

TierCostCreditsSectionsBest for
Basic$0.50500I-VIIIWeekly monitoring, automated pipelines
Pro$1.501,500I-XClient reports, strategy planning

Get your API key

Start generating reports in 3 minutes. No credit card required for the first 100 API calls.