Reddit Scraper - Monitoring, Signals & Attention Queue
Pricing
Pay per usage
Scrapes Reddit and returns a ranked attention queue: brand monitoring, mention tracking, sentiment analysis, and breakout detection in one run. Drop-in compatible with existing Reddit scraper workflows. $0.002 per record.
Schema Version
schemaVersion
Optional
Output schema version (additive-only across minor versions). Pin automations to this.
Record Type
recordType
Optional
Discriminator. Stable enum: 'post', 'comment', 'community', 'user', 'search_result', 'summary', 'error'. Filter on this to separate entity types.
Event ID
eventId
Optional
Stable dedup key. Native Reddit fullnames (t3_ posts, t1_ comments, t5_ communities, t2_ users) used directly; synthetic records (mention rollups, summaries) use sha256 prefixed 'syn_'. This is what watchlist delta diffs on across runs.
Attention Index
attentionIndex
Optional
The single sortable composite (0-100). { value, breakdown: { activeSignals, mentionSpike, sentimentShift, breakoutStrength, communityMomentum }, drivers[] }. Bounded contributions, no single component dominates. Distinct from per-event signalStrength and from momentum trajectory.
Watch Status
watchStatus
Optional
Top-level routing primitive. Stable enum: 'no-action', 'monitor', 'attention-required', 'urgent', 'critical'. Branch on this (WHERE watchStatus IN ('urgent','critical')), never on raw scores.
Why Now
whyNow
Optional
Plain-English reasons this record needs attention now, drawn from active signal events. Empty when nothing fired.
Agent Decision
agentDecision
Optional
Flat decision enum for automation: 'review_now', 'monitor', 'ignore'. The flat projection of agentContract.decision.
Recommended Action
recommendedAction
Optional
Short human label derived from attentionWindow. Prioritisation instruction only (Review / Read / Monitor / Track / Re-check / Compare / Investigate). Never an in-Reddit engagement instruction. Max 80 chars.
Attention Window
attentionWindow
Optional
The MACHINE primitive automation branches on: { urgency (high|medium|low|none), recommendedReviewWithinHours }. recommendedAction is derived from this.
Attention Priority
attentionPriority
Optional
Stable enum: 'high', 'medium', 'low', 'none'.
Deprioritization Reasons
deprioritizationReasons
Optional
Populated when attentionPriority is low or none - why this row was filtered out, so the buyer can audit and learn to trust the filtering.
Community
communityName
Optional
Subreddit name (e.g. r/Notion). Present on post, comment, and community records.
Signal Events
signalEvents
Optional
Typed, evidenced events. Each: { type, signalStrength (heuristic 0-1, NOT calibrated probability), active, firstDetectedAt, peakAt, daysSincePeak, decayStatus (fresh|active|fading|expired), evidenceGrade (weak|moderate|strong), reason, evidence }. Stable type enum: breakout_post, community_acceleration, community_deceleration, topic_surge, sentiment_shift, mention_spike, author_emergence, contested_thread.
Expired Signals
expiredSignals
Optional
Events that aged out of the attention window, kept one run for history then dropped.
Signal Profile
signalProfile
Optional
Community archetype this run. Stable enum (8): emerging, breakout, stable-authority, viral-fragile, high-engagement-niche, decelerating, dormant, unclassified.
Signal Profile Strength
signalProfileStrength
Optional
Heuristic confidence 0-1 in the assigned community profile.
Signal Profile Evidence
signalProfileEvidence
Optional
Plain-English heuristics behind the assigned profile.
Why This Matters
whyThisMatters
Optional
Per-post operational notes (post records): breakout velocity, top comment themes, comment velocity, etc.
Comment Intelligence
commentIntelligence
Optional
Deterministic comment synthesis (lexicon-tfidf-v1, NO external LLM). { status (full|lexicon_fallback|disabled), method, sampleSize, sentiment { positive, negative, neutral, confidenceBand }, themes[] (stable themeCode enum + label + weight + keywords + exampleCommentIds), audienceSignals[], limitations[] }. Re-runs byte-identical.
Actionability
actionability
Optional
0-1: how worth acting on NOW (evidence strength x freshness x magnitude). Ops teams sort by this.
Materiality
materiality
Optional
0-100: how much this matters to the tracked term / persona, weighted by the persona pack. Brand teams sort by this.
Materiality Drivers
materialityDrivers
Optional
The weighted components behind materiality + top drivers (full explainability only).
Signal Trajectory
signalTrajectory
Optional
State backbone (consolidates momentum + volatility + trend). { direction (accelerating|rising|stable|fading|volatile|unknown), velocity, stability, phase (emergence|expansion|plateau|decay|dormant), trendDurationDays, trajectoryClass (emerging-risk|stable-issue|fading|recurring|noise|unknown) }. Maturity-gated: 'unknown' until >=3 runs.
Persistent Signal
persistentSignal
Optional
Recurrence classification from accumulated state. { signalKey, firstSeenAt, runsSeen, activeRuns, consecutiveRuns, historicalPeakAttentionIndex, currentTrend, persistenceClass (transient|recurring|persistent|cyclical|dormant), origin }. Null until monitoring with history. Cannot be backfilled.
Signal Exhaustion
signalExhaustion
Optional
Novelty fatigue. { status (fresh|aging|fatigued), daysActive, noveltyDecay, reason }. Chronic-but-elevated signals de-escalate. Distinct from time-since-peak decay.
Signal Rarity
signalRarity
Optional
{ rarityScore, historicalOccurrenceRate, rarityClass (common|uncommon|rare|unknown) }. A rare medium spike can out-rank a common huge one. Maturity-gated: 'unknown' until history is deep enough.
Narrative Memory
narrativeMemory
Optional
Cross-run topic memory (the lock-in). { topic, firstSeenAt, historicalPeaks, averageCycleLengthDays, seasonalityDetected, reEmergenceProbability, memoryDepth (insufficient|building|mature) }. Advanced fields stay null until enough cycles exist - never a fabricated cycle.
Community Health
communityHealth
Optional
Per-community: { status (stable|destabilizing|unknown), engagementTrend (steady|volatile), narrativeFragmentation }. No moderationPressure field - it is unobservable from a public scrape.
State Transition
stateTransition
Optional
Monitor mode: { previous, current, direction (deteriorating|improving|unchanged|first-sight), daysInPreviousState, changedAt }.
Agent Contract
agentContract
Optional
Compact decision surface for MCP/AI/RAG consumers: { decision, attentionPriority, whyNow, recommendedAction }.
Suppressed Signals
suppressedSignals
Optional
Signals that fired but were judged noise, WITH reason and noiseRisk. Surfaced, never silently dropped. Seeing what the actor ignored builds trust in the alerts it raises.
Alert Quality
alertQuality
Optional
{ novelty, urgency, noiseRisk } 0-1. Slack/Zapier/agent monitors filter WHERE noiseRisk < 0.3 to kill alert fatigue.
Signal Lineage
signalLineage
Optional
Escalation provenance: { derivedFrom[], primaryDriver, secondaryDrivers[] } (full explainability only).
Reddit Sort Rank
redditSortRank
Optional
Original Reddit sort position (search/monitor).
Reranked Rank
rerankedRank
Optional
Position after reranking by the chosen rankBy axis.
Rank By
rankBy
Optional
Axis used for reranking.
Rerank Reason
rerankReason
Optional
Why this result ranks where it does.
Rerank Axes
rerankAxes
Optional
All axis ranks: byRelevance, byBreakoutPotential, byMomentum, byEngagement, byRecency, byAttention.
Change Flags
changeFlags
Optional
Monitor mode: machine flags such as NEW_BREAKOUT, MENTION_SPIKE, SENTIMENT_DOWN, SIGNAL_EXPIRED, STATE_DETERIORATING.
New Signals Since Last Run
newSignalsSinceLastRun
Optional
Monitor delta: what newly fired since the previous run. Empty with first-sight framing on the first run.
Title
title
Optional
Post title (compat substrate field, identical name/type to the incumbent).
URL
url
Optional
Canonical Reddit URL (compat substrate field).
Up Votes
upVotes
Optional
Upvote count (compat substrate field, identical name/type to the incumbent).
Number Of Comments
numberOfComments
Optional
Comment count (compat substrate field).
Data Type
dataType
Optional
Compat substrate discriminator: post | comment | community | user. Identical name/type to the incumbent for drop-in migration.
Headline
headline
Optional
Summary record: one-line run headline.
Run Outcome
runOutcome
Optional
Summary record: quiet-mode status { status (quiet|active|high-activity), message, suppressedCount, attentionCount }. A monitor that says 'nothing fired' is trusted when it does fire.
Portfolio State
portfolioState
Optional
Summary record: CIO-glance over the run { overallActivity, attentionCount, trend, dominantTopics[], attentionIndexDistribution, analysisScope }.
Daily Briefing
dailyBriefing
Optional
Summary record: { generatedBy: 'template-briefing-v1', bullets[] }. Deterministic template assembly, not generated prose.
Spreadsheet Collapse
spreadsheetCollapse
Optional
Summary record: estimated manual triage time saved. estimateBasis is 'heuristic'; calibrated against buyer feedback.
Public Data Compliance
publicDataCompliance
Optional
Summary record: read-only posture, machine-readable and auditable. inRedditActionsPerformed is hard-wired false - the actor cannot post/reply/vote/DM by design.
Coverage
coverage
Optional
Summary record: { requestedCommunities, communitiesScanned, communitiesSkipped, skipReasons[] (typed: private_or_unavailable|rate_limited|not_found|blocked), postsCollected, commentsCollected, coverageStatus (complete|partial) }.
Trust Diagnostics
trustDiagnostics
Optional
Summary record: { suppressedSignals, ignoredCrossposts, deduplicatedThreads, confidenceInCoverage, noveltyThresholdApplied }.
Run Manifest
runManifest
Optional
Summary record: all version constants pinned (signalDetection, signalProfile, attentionRouter, watchlistComputation, topicMethod, commentIntelligence, attentionIndexWeights, personaWeights, decayTable, commentLexicon) + resolved mode/persona/outputProfile/watchlistName. Diff manifests across runs to catch rule drift.
![🛒 TikTok Shop Scraper - Find Winning Products [NO LOGIN] ✅ avatar](https://images.apifyusercontent.com/19hg3d40D0AYRrOpNZsFNdyRHHdIZBNmXd51M9i64RI/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vc0NDU2R3bm1LTUoxUTJzVG4tYWN0b3ItQzk3U1VpTWxiWjc1eDZ1MjItTTRLdXpqR2FERi10aWt0b2stbG9nby1wbmctZmlsZS0xMTY2MTYzNzYyNng0cTF3c2djc3kucG5n.webp){kind=avatar}
