> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dripstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> Key ideas in the Drip API: publications, posts, search, and paid article summaries.

Drip is organized around a few simple API concepts. Search across supported
financial newsletters, blogs, and podcasts, choose a relevant post, then unlock the paid
summary when your agent needs it for research.

## Publication

A **publication** is a supported source, such as a newsletter, blog, or podcast.
It is identified by a **`publicationSlug`**, typically a normalized hostname.

| Source URL | `publicationSlug` |
| - | - |
| `https://michaeljburry.substack.com` | `michaeljburry.substack.com` |
| `https://unchainedcrypto.beehiiv.com` | `unchainedcrypto.beehiiv.com` |

Use `GET /api/v1/publications` to list the curated catalog, or
`GET /api/v1/publications/search?q=...` to find a source by name. Details:
[Publications](/publications).

## Post

A **post** is an article or podcast episode from a publication. It is addressed by its
publication plus its own **`slug`**:

```text theme={null}
GET /api/v1/publications/{publicationSlug}/{postSlug}
```

Search results include both `publicationSlug` and `slug`, so an agent can build
the paid article URL directly from a search result.

## Search

**Search** (`GET /api/v1/search`) is the free discovery layer. Use it to find
candidate posts by topic across supported sources.

The response includes:

| Field | Meaning |
| - | - |
| `items` | Ranked post candidates with fields such as `publicationSlug`, `slug`, `title`, and date |
| `mode` | Search strategy used: `hybrid` combines semantic and keyword search; `fts` is keyword-only |
| `matchConfidence` | Overall result quality: `strong`, `weak`, or `none` |
| `count` | Number of items returned after applying the requested `limit` |

Each item also includes the effective `priceCents` for the post.

Treat `items` as candidates. Fetch the selected post from the paid article
endpoint to receive its robust summary. Parameters, filters, and a full
example: [Topic Search](/search).

## Company lookup

`GET /api/v1/companies` returns an identity card (`name`, ticker, domain, CIK)
for "who is NVDA?" — not articles that mention the company. See
[Company Lookup](/companies).

## Entity search

`GET /api/v1/entities/search` lists curated articles that mention a ticker,
company, person, organization, or subject, sorted by publish date. Start with
[Search Articles by Ticker](/entity-search/ticker). The response includes
`matchedEntity`.

## Top-selling

`GET /api/v1/posts/top-selling` and `GET /api/v1/publications/top-selling`
are free ranked lists for popular items. See [Top-selling](/top-selling).

## Paid Article Summaries

A paid post request returns metadata and a robust `synthesizedSummary`.
Podcast episodes also return `transcript` when available; other posts return
`transcript: null`.
Newsletter and blog responses do not include full article text. The
first successful pay unlocks that post forever for the paying subject (Drip user
for credits / MCP OAuth / API key / JWT; wallet or MPP credential for those
rails). Later fetches return the live summary with no charge and no new sale.

Payment clients use x402 on Base or Solana, or MPP on Tempo or Stripe. An unpaid
request returns a `402` challenge containing the authoritative runtime price.
API-key requests spend account credits instead. x402/MPP clients should
store `unlockToken` (or the `X-Drip-Unlock` response header) and resend it as
the request header `X-Drip-Unlock` for free re-reads.

This lifetime unlock applies to individual posts. Paid stock-picks bundles are
charged per request and do not unlock their source posts. Stock Picks V2 also
supports subscription access; see [Stock Picks](/stock-picks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.