Access SEC 13F-HR filing data including market flows, institutional holders, and activist positions. Track what hedge funds, index funds, and activist investors are buying and selling.

Aggregate institutional activity per ticker

Institutional holders for a specific stock

Activist investor positions (new/increased stakes)

Institutional Flows API

Search and retrieve sentiment metrics for news articles, social media posts, and AI-curated news stories across multiple sources.

Get document metrics for a ticker within a date range

Get document metrics mentioning a KB entity

Smart search with natural language queries

Get latest document metrics from a specific source

Get top news stories with sentiment metrics

Documents & News API

Real-time stock prices, historical charts, company fundamentals, short interest data, and AI-powered stock analysis.

Stocks API

<h2>Base URL</h2>
<p>All API requests use the following base URL:</p>
<pre><code>https://app.sentisense.ai
</code></pre><h2>Authentication</h2>
<p>SentiSense supports two authentication methods:</p>
<h3>API Key (Recommended)</h3>
<p>Include your API key in the <code>X-SentiSense-API-Key</code> header:</p>
<pre><code class="hljs language-bash">curl -H <span class="hljs-string">&quot;X-SentiSense-API-Key: ssk_YOUR_KEY&quot;</span> \
  <span class="hljs-string">&quot;https://app.sentisense.ai/api/v1/institutional/flows?reportDate=2025-02-14&quot;</span>
</code></pre><p>API keys are available to <strong>PRO</strong> subscribers. Generate one in <strong>Settings &gt; Developer Console</strong> within the app.</p>
<h3>Session-Based</h3>
<p>For browser-based integrations, authenticate via the login endpoint and use session cookies:</p>
<pre><code class="hljs language-bash">curl -c cookies.txt -X POST \
  -H <span class="hljs-string">&quot;Content-Type: application/json&quot;</span> \
  -d <span class="hljs-string">&#x27;{&quot;email&quot;:&quot;you@example.com&quot;,&quot;password&quot;:&quot;...&quot;}&#x27;</span> \
  <span class="hljs-string">&quot;https://app.sentisense.ai/api/auth/login&quot;</span>
</code></pre><h2>Public vs. Authenticated Endpoints</h2>
<p>Many endpoints are publicly accessible without any authentication:</p>
<table>
<thead>
<tr>
<th>API Group</th>
<th>Auth Required?</th>
</tr>
</thead>
<tbody><tr>
<td>Stock prices, charts, fundamentals</td>
<td>No</td>
</tr>
<tr>
<td>News articles and search</td>
<td>No</td>
</tr>
<tr>
<td>News stories (list)</td>
<td>No</td>
</tr>
<tr>
<td>News story detail</td>
<td>Free with quota, unlimited for PRO</td>
</tr>
<tr>
<td>Institutional flows (preview)</td>
<td>No (top 2-3 results)</td>
</tr>
<tr>
<td>Institutional flows (full)</td>
<td>PRO</td>
</tr>
<tr>
<td>AI stock summaries</td>
<td>PRO</td>
</tr>
<tr>
<td>API key management</td>
<td>PRO</td>
</tr>
</tbody></table>
<h2>Rate Limits</h2>
<p>All API access requires an API key. Generate one for free in <strong>Settings &gt; Developer Console</strong>.</p>
<table>
<thead>
<tr>
<th>Tier</th>
<th>API Requests / Month</th>
<th>Notes</th>
</tr>
</thead>
<tbody><tr>
<td>Free</td>
<td>100</td>
<td>Preview access — generate key in Developer Console</td>
</tr>
<tr>
<td>PRO ($15/mo)</td>
<td>10,000</td>
<td>Full access</td>
</tr>
</tbody></table>
<p>When you exceed your rate limit, the API returns <code>429 Too Many Requests</code> with details:</p>
<pre><code class="hljs language-json"><span class="hljs-punctuation">{</span>
  <span class="hljs-attr">&quot;error&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;quota_exceeded&quot;</span><span class="hljs-punctuation">,</span>
  <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Monthly API request quota exceeded&quot;</span><span class="hljs-punctuation">,</span>
  <span class="hljs-attr">&quot;quotaLimit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">10000</span><span class="hljs-punctuation">,</span>
  <span class="hljs-attr">&quot;quotaUsed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">10001</span>
<span class="hljs-punctuation">}</span>
</code></pre><h2>Error Codes</h2>
<table>
<thead>
<tr>
<th>Code</th>
<th>Meaning</th>
</tr>
</thead>
<tbody><tr>
<td><code>200</code></td>
<td>Success</td>
</tr>
<tr>
<td><code>400</code></td>
<td>Bad request (missing/invalid parameters)</td>
</tr>
<tr>
<td><code>401</code></td>
<td>Unauthorized (invalid or missing API key)</td>
</tr>
<tr>
<td><code>403</code></td>
<td>Forbidden (insufficient tier for this endpoint)</td>
</tr>
<tr>
<td><code>404</code></td>
<td>Resource not found</td>
</tr>
<tr>
<td><code>429</code></td>
<td>Rate limit exceeded</td>
</tr>
<tr>
<td><code>500</code></td>
<td>Internal server error</td>
</tr>
</tbody></table>
<h2>Quickstart</h2>
<h3>With curl</h3>
<pre><code class="hljs language-bash"><span class="hljs-comment"># Get real-time stock price (no auth required)</span>
curl <span class="hljs-string">&quot;https://app.sentisense.ai/api/v1/stocks/price?ticker=AAPL&quot;</span>

<span class="hljs-comment"># Get sentiment metrics for a stock&#x27;s news</span>
curl <span class="hljs-string">&quot;https://app.sentisense.ai/api/v1/documents/ticker/AAPL?limit=5&quot;</span>

<span class="hljs-comment"># Get institutional flows (requires PRO API key)</span>
curl -H <span class="hljs-string">&quot;X-SentiSense-API-Key: ssk_YOUR_KEY&quot;</span> \
  <span class="hljs-string">&quot;https://app.sentisense.ai/api/v1/institutional/flows?reportDate=2025-02-14&quot;</span>
</code></pre><h3>With Python</h3>
<pre><code class="hljs language-python"><span class="hljs-keyword">from</span> sentisense <span class="hljs-keyword">import</span> SentiSenseClient

<span class="hljs-comment"># Public endpoints (no key needed)</span>
client = SentiSenseClient()
price = client.get_stock_price(<span class="hljs-string">&quot;AAPL&quot;</span>)
<span class="hljs-built_in">print</span>(<span class="hljs-string">f&quot;AAPL: $<span class="hljs-subst">{price[<span class="hljs-string">&#x27;price&#x27;</span>]}</span>&quot;</span>)

<span class="hljs-comment"># PRO endpoints</span>
client = SentiSenseClient(api_key=<span class="hljs-string">&quot;ssk_YOUR_KEY&quot;</span>)
flows = client.get_institutional_flows(<span class="hljs-string">&quot;2025-02-14&quot;</span>)
<span class="hljs-keyword">for</span> flow <span class="hljs-keyword">in</span> flows[<span class="hljs-string">&quot;inflows&quot;</span>]:
    <span class="hljs-built_in">print</span>(<span class="hljs-string">f&quot;<span class="hljs-subst">{flow[<span class="hljs-string">&#x27;ticker&#x27;</span>]}</span>: net buy <span class="hljs-subst">{flow[<span class="hljs-string">&#x27;netSharesChange&#x27;</span>]:,}</span> shares&quot;</span>)
</code></pre>

SentiSense API documentation - authentication, rate limits, error codes, and quickstart guide.

API Documentation

Quick Start

API Reference

Institutional Flows API

Documents & News API

Stocks API

Rate Limits

Tier	Price	API Requests / Month	Key Features
Free	$0	100	Preview access — generate key in Developer Console
PRO	$15/mo	10,000	Full access — institutional data, AI analysis