Embed Trawl in Your App
Drop a live intelligence feed into any React app. Three components, zero backend required. Data refreshes automatically from our public API.
TrawlFeed
A compact card showing a full intelligence report for any ticker. Includes AI summary, sentiment, and collapsible sections for Reddit, news, insider trades, SEC filings, earnings, congressional trading, and Wikipedia pageviews.
Live Preview
Installation
// Copy the component from your Trawl project
// frontend/components/embeds/trawl-feed.tsx
// Or install from npm (coming soon):
// npm install @trawl/embedUsage
import { TrawlFeed } from '@trawl/embed';
// Full mode (default)
<TrawlFeed ticker="NVDA" theme="dark" />
// Compact mode — headline + sentiment + key findings only
<TrawlFeed ticker="NVDA" compact />
// Light theme
<TrawlFeed ticker="AAPL" theme="light" />
// Select specific sections
<TrawlFeed
ticker="TSLA"
sections={["reddit", "news", "insider_trades"]}
/>
// Hide the CTA link
<TrawlFeed ticker="MSFT" showCTA={false} />Props
| Prop | Type | Default | Description |
|---|---|---|---|
| ticker | string | - | Stock ticker symbol (required) |
| sections | SectionKey[] | all | Which data sections to show |
| theme | "dark" | "light" | "dark" | Color theme |
| compact | boolean | false | Show only headline, sentiment, and key findings |
| showCTA | boolean | true | Show "View full report" link |
TrawlTickerBadge
A tiny inline badge showing Reddit-sourced sentiment for a ticker. Perfect for blog posts, dashboards, and data tables. Links to the full Trawl report.
Live Preview
Inline Example
The market is watching closely after the latest earnings beat. Meanwhile sentiment has shifted following the robotaxi announcement.
Usage
import { TrawlTickerBadge } from '@trawl/embed';
// Basic badge
<TrawlTickerBadge ticker="NVDA" />
// With confidence score
<TrawlTickerBadge ticker="AAPL" showScore />
// Light theme (for white backgrounds)
<TrawlTickerBadge ticker="TSLA" theme="light" />
// Inline in text
<p>
Investors are watching <TrawlTickerBadge ticker="NVDA" /> closely
after the latest earnings report.
</p>Props
| Prop | Type | Default | Description |
|---|---|---|---|
| ticker | string | - | Stock ticker symbol (required) |
| showScore | boolean | false | Show confidence percentage |
| theme | "dark" | "light" | "dark" | Color theme |
TrawlPulseCard
An alt data pulse card showing cross-referenced financial signals for any ticker. Surfaces insider trading, congressional activity, and news velocity signals with a composite alt data score. Free, no API key required.
Live Preview
Usage
import { TrawlPulseCard } from '@trawl/embed';
// Alt data pulse for a ticker
<TrawlPulseCard ticker="NVDA" />
// Light theme
<TrawlPulseCard ticker="AAPL" theme="light" />
// Without related tickers
<TrawlPulseCard ticker="TSLA" showRelated={false} />Props
| Prop | Type | Default | Description |
|---|---|---|---|
| ticker | string | - | Stock ticker symbol (required) |
| theme | "dark" | "light" | "dark" | Color theme |
| showRelated | boolean | true | Show related tickers with their scores |
CDN Usage
No React? No problem. Drop a script tag and use data attributes. Works in any HTML page, blog, or CMS.
<!-- Trawl Embed Script -->
<script src="https://gettrawl.com/embed.js" defer></script>
<!-- Full feed widget -->
<div data-trawl-feed="NVDA" data-theme="dark"></div>
<!-- Compact feed -->
<div data-trawl-feed="AAPL" data-theme="light" data-compact="true"></div>
<!-- Ticker badge -->
<span data-trawl-badge="TSLA"></span>
<!-- Badge with score -->
<span data-trawl-badge="MSFT" data-show-score="true"></span>
<!-- Alt data pulse card -->
<div data-trawl-pulse="NVDA"></div>Coming soon: The CDN embed script is under development. For now, use the React components directly. Join our waitlist to be notified when it ships.
How it works
Drop in the component
Import TrawlFeed, TrawlTickerBadge, or TrawlPulseCard into your React app. No API key needed.
Auto-fetches from our API
Components call the public Trawl API on mount. No backend or proxy required. CORS is open.
Stays fresh automatically
TrawlFeed refreshes every hour. TrawlTickerBadge refreshes every 30 minutes. Zero maintenance.
Want more data?
Get full API access with authenticated endpoints, webhooks, watches, and AI features.