Intelligence Reports API

Your Audience Is Talking. Here Is What They Are Actually Saying.

Your audience left 258 comments on your last video. You scrolled through 30, liked a few, and moved on. Somewhere in those 258 comments was a coordinated spam ring, a superfan about to churn, and the exact topic your next video should cover. You missed all three.

That is the gap between reading comments and reading your audience. Today we are shipping the Intelligence Report API to close it.

What Is an Audience Intelligence Report?

An audience intelligence report is a structured analysis of your comment section. Not word clouds or sentiment percentages, but the kind of analysis a $500/hour media strategist would produce: who your audience clusters are, what narratives they are pushing, which accounts are bots, and exactly what you should do next.

NAWA's /v1/report endpoint takes raw comments as input and returns a report with eight sections (Basic) or 10 sections (Pro). One API call. No ML expertise required.

What the Report Tells You

Pro tier adds Repeat Commenter Analysis (superfan detection) and a Content Brief with three episode concepts and an engagement playbook.

How It Works

One API call. Pass your comments, get your report.

```bash

curl -X POST https://api.trynawa.com/v1/report \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"comments": [

{"text": "Best tech review I have seen", "author": "TechFan42", "likes": 156},

{"text": "You are just fear mongering", "author": "SkepticalSteve", "likes": 89},

{"text": "My company laid off 200 people because of AI", "author": "AnxiousWorker", "likes": 234}

],

"tier": "pro",

"title": "AI Is Coming For Your Job",

"channel_context": "Tech commentary, 500K subscribers"

}'

```

The response includes both markdown (render however you want) and a pre-parsed sections object (plug directly into your dashboard). Full API documentation.

[Screenshot suggestion: show the JSON response with clusters highlighted]

Real Example: What 12 Comments Reveal

We tested the API with 12 comments from a tech video. Here is what it found in under 15 seconds:

Three audience clusters detected:

• "Career-Threatened Professionals" (33%, ESCALATING) - sharing personal layoff stories
• "Content Quality Evaluators" (42%, STABLE) - fact-checking statistics and praising clarity
• "Mission-Aligned Advocates" (25%, RISING) - positioning the creator as a truth-teller

-

Key finding the API surfaced: "Fear is the engagement driver, not optimism. The 234-like comment about real layoffs proves viewers came for actionable career intelligence, not theoretical discussion."

Recommendation #1: "Produce the creative jobs follow-up within seven days - @ArtistMike's 78-like comment identifies a coverage gap that your Career-Threatened Professionals cluster needs addressed."

That level of analysis from 12 comments. Imagine what it finds with 200.

How NAWA Compares to Manual Analysis

Pricing: Basic vs Pro

Credits never expire. Purchase at trynawa.com/developers/keys. The $25 Starter pack (25,000 credits) covers 50 Basic or 16 Pro reports.

Three Use Cases

Agencies managing creator accounts

Generate Pro reports for 20 clients every week. API cost: $120/month. Bill each client $50/report. Revenue: $4,000/month from a $120 investment. The markdown output renders in any template you choose.

SaaS tools building analytics dashboards

Embed audience intelligence into your product using the sections object. Your users get cluster analysis, narrative mapping, and strategic recommendations without you building the ML pipeline. Integration guide.

Solo creators who want signal, not noise

Run a Basic report after every video. For $0.50 you learn more than 45 minutes of scrolling. Set up a weekly cron job and get a Monday morning briefing in Slack.

The Arabic Advantage

NAWA is the only comment analysis API that handles Arabic natively. Arabic comments route to HUMAIN's ALLaM large language model for dialect-accurate classification (Gulf, Egyptian, Levantine, MSA - 100% accuracy). English routes to Claude. Same endpoint, same price, same response shape.

If your audience spans Arabic and English - and with 422 million Arabic speakers online, it should - you do not need two tools.

```

// Arabic comment correctly classified in your report

"@أحمد_المهندس (33 likes): ما شاء الله عليك محتوى رهيب!"

// Detected: Gulf Arabic, praise, positive sentiment

```

(ما شاء الله عليك محتوى رهيب = "Incredible content, mashallah!")

Frequently Asked Questions

What is a YouTube comment analysis API?

A YouTube comment analysis API takes raw comment text and returns structured intelligence: intent classification, sentiment analysis, audience clustering, and strategic recommendations. NAWA's API handles both Arabic and English comments in a single endpoint.

How many comments do I need for a useful report?

Minimum 10 comments. For richer cluster detection and narrative mapping, 50-200 comments is ideal. Maximum 500 per request.

Can I use this for Instagram or TikTok comments?

Yes. The API accepts any text as comments. Pass Instagram, TikTok, X, or LinkedIn comments in the same format. The platform field in the channel_context parameter helps the AI tailor recommendations.

Is the report available in Arabic?

The API analyzes Arabic comments natively and includes them in the English-language report. Full Arabic report output is on the roadmap.

How is this different from YouTube Studio analytics?

YouTube Studio shows you metrics: view count, watch time, subscriber change. NAWA shows you meaning: who your audience clusters are, what narratives are growing, which commenters are bots, and what to do about it. They complement each other.

Start Generating Reports

Get your API key at trynawa.com/developers/keys. No credit card required for your first 100 API calls (classify, detect, reply). Reports require purchased credits starting at $25 for 25,000 credits.

Read the full API documentation or the intelligence reports guide for integration patterns.

Your audience is telling you exactly what they want. The question is whether you are listening.

LinkedIn (1,280 chars):

Your audience left 258 comments. You scrolled through 30 and moved on.

Somewhere in there was a spam ring, a superfan about to churn, and the exact topic for your next video. You missed all three.

Today we shipped the Intelligence Report API. One endpoint that turns comments into what a $500/hour analyst would deliver:

• 3-6 audience clusters with trajectory (ESCALATING/STABLE/DECLINING)

-

• Dominant narratives ranked by strength
• Bot campaigns named account-by-account
• 6 data-backed strategic recommendations

-

Real test: 12 comments on a tech video. API found 3 clusters, identified fear as the engagement driver (not optimism), and recommended a creative jobs follow-up based on a 78-like comment.

Basic: $0.50. Pro: $1.50. Arabic + English.

developers.trynawa.com/api-reference/report

X thread (5 tweets):

1/ We shipped the Intelligence Report API today. One endpoint turns YouTube comments into what a $500/hour analyst would deliver. $0.50 per report.

2/ What it finds: 3-6 audience clusters with trajectory, dominant narratives ranked by strength, coordinated bot campaigns named account-by-account, six data-backed recommendations.

3/ Real test: 12 comments on a tech video. API found "Career-Threatened Professionals" (33%, ESCALATING), "Content Quality Evaluators" (42%, STABLE), "Mission-Aligned Advocates" (25%, RISING).

4/ The Arabic advantage: only API that handles Arabic natively. 422M Arabic speakers. Same endpoint, same price. Gulf, Egyptian, Levantine, MSA - 100% dialect accuracy.

5/ Basic $0.50 (8 sections), Pro $1.50 (10 sections + content brief). Get your API key: developers.trynawa.com. No credit card for first 100 calls.

Newsletter (98 words):

New: Intelligence Report API. Turn YouTube comments into audience intelligence - clusters, narratives, spam detection, and strategic recommendations. One API call, $0.50 per report. Arabic + English in the same endpoint.