> ## 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.

# Integration Levels

> What a full Drip integration includes, and what each level costs.

Drip has four levels of integration. Most partial integrations stop at the first
one because the free routes look complete on their own.

**Discover alone is not an integration.** It returns metadata about articles the
caller cannot read — titles, authors, prices, dates.

> [card] 1. Discover
>
> Post cards, titles, authors, dates, prices, publications, podcasts, company and entity cards.
> **Free.**

> [card] 2. Read
>
> Full synthesized summaries of premium posts and podcast transcripts. First paid read unlocks
> that post forever. **Per post.**

> [card] 3. Analyze
>
> Analyst stock picks, per-ticker calls, bull/bear views, full pick archive. **Subscription or
> pay-per-use.**

> [card] 4. Operate
>
> Credit balance and top-up, credit ledger, lifetime unlocks, subscription management. **Account
> plus credits.**

## Routes per level

| Level | Routes |
| - | - |
| Discover | `GET /api/v1/search`, `GET /api/v1/entities/search`, `GET /api/v1/companies`, `GET /api/v1/companies/{companyId}`, `GET /api/v2/sources` |
| Read | `GET /api/v2/sources/{sourceSlug}/{postSlug}` |
| Analyze | `GET /api/v2/stock-picks`, `GET /api/v2/stock-picks/quote`, `GET /api/v2/tickers/{ticker}`, `GET /api/v2/sources/{slug}/stock-picks` |
| Operate | `GET /api/v1/me`, `GET /api/v1/me/credits`, `GET /api/v1/me/credits/activity`, `GET /api/v1/me/unlocks` |

Discovery routes are free and need no credential. Read and Analyze routes are
paid — see [Payment Options](https://docs.dripstack.com/concepts/payment-flow.md) for x402/MPP and
[API key + credits](https://docs.dripstack.com/quickstart-api-keys.md).

## Building an app on Drip

Wire all four levels, not just the article routes. An app that shows article
summaries but no analyst calls misses most of what Drip is for — stock picks
(`GET /api/v2/stock-picks`) are the flagship feed.

| Level | Add to your app |
| - | - |
| Discover | Search, entity search, publications, company lookup — free, no credential |
| Read | One paid route per article you show, plus the price before the read |
| Analyze | `GET /api/v2/stock-picks` (daily picks) and `GET /api/v2/tickers/{ticker}` (calls on one name) |
| Operate | `GET /api/v1/me/credits` so the app can show a balance and a top-up link |

Two details that decide whether the app feels right:

* Show the price before a paid read. `priceCents` is on every discovery card;
  quote it before unlocking so the user knows what the read costs.
* Treat the first paid read as a permanent unlock. Store `unlockToken` (or the
  `X-Drip-Unlock` header) and resend it — later reads of the same post are free.

## "I only wired search"

If your integration calls `GET /api/v1/search` and nothing else, it delivers
post cards. Your users see titles and authors with no article content behind
them. To reach Read, add one paid route call:

```typescript theme={null}
const post = search.items[0];
const article = await fetch(
  `https://dripstack.com/api/v2/sources/${post.publicationSlug}/${post.slug}`,
  { headers: { Authorization: `Bearer ${process.env.DRIP_API_KEY}` } },
).then((response) => response.json());

console.log(article.synthesizedSummary);
```

That single addition is what turns a discovery demo into a working integration.
See [Quickstart: API Keys](https://docs.dripstack.com/quickstart-api-keys.md) for the credential setup and
[Credits](https://docs.dripstack.com/credits.md) for how payment works.

## Ask your agent for a full integration

An agent that can reach a free route will usually stop there and report the
integration as done. Paste the prompt below into the agent that is integrating
Drip — the canonical copy lives at
`https://dripstack.com/integration-prompt.txt` (copy button on
[dripstack.com/connect/agent](https://dripstack.com/connect/agent)):

```text theme={null}
Read https://dripstack.com/SKILL.md and follow the instructions. Integrate Drip into this app as a full integration: post cards, paid article summaries, stock picks, and credits. When you finish, tell me which Drip capabilities you wired, which you did not, and what each missing capability costs.
```

The instruction matters: without it, an agent that stops at a free route reports
the integration as done.


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