Quickstart: API Keys

Use API keys when your agent, backend job, or research pipeline wants a traditional bearer token instead of wallet-based x402 or MPP payments. An API key authorizes paid article reads with Authorization: Bearer pk_drip_... and spends your pre-purchased credits. Search and publication discovery routes are free. Each successful paid request returns a robust synthesized summary of a publisher’s article. The first successful pay for a post unlocks it forever for that Drip account — API key, in-app chat/JWT, and MCP OAuth tokens for the same user share the entitlement. Later unlocks of the same post do not spend credits. For production usage, follow Errors & Retries.

Create an API key and add credits

Sign in to Drip, then create a key from the API Keys dashboard. Copy the key when it is shown; raw keys are not displayed again.Add balance from the Credits dashboard.

Search across supported sources

Search across all supported financial newsletters and blogs for posts relevant to your research question.

curl "https://dripstack.com/api/v1/search?q=DeFi%20security&limit=20"

{
  "mode": "hybrid",
  "query": "DeFi security",
  "matchConfidence": "strong",
  "count": 20,
  "items": [
    {
      "publicationSlug": "unchainedcrypto.beehiiv.com",
      "slug": "defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit",
      "title": "DeFi United Unveils Plan to Restore rsETH After $292M Kelp DAO Exploit",
      "publishedAt": "2026-04-28T11:00:00.000Z"
    },
    {
      "publicationSlug": "unchainedcrypto.beehiiv.com",
      "slug": "the-kelp-dao-exploit-bill-is-coming-due",
      "title": "The Kelp DAO Exploit Bill Is Coming Due",
      "publishedAt": "2026-04-21T11:00:56.000Z"
    }
    // ...18 more results
  ]
}

Each result includes publicationSlug and slug. Use those two values to build the paid article URL. Search results are candidates, not paid article summaries.

Query a specific publication

If you already know which source you care about, find the publication slug and list its ready posts.

curl "https://dripstack.com/api/v1/publications/search?q=Unchained%20Daily%20Newsletter"

curl "https://dripstack.com/api/v1/publications/unchainedcrypto.beehiiv.com?limit=20"

{
  "slug": "unchainedcrypto.beehiiv.com",
  "title": "Unchained Daily Newsletter",
  "posts": [
    {
      "slug": "defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit",
      "title": "DeFi United Unveils Plan to Restore rsETH After $292M Kelp DAO Exploit",
      "publishedAt": "2026-04-28T11:00:00.000Z",
      "priceCents": null
    },
    {
      "slug": "fork-in-the-road",
      "title": "Fork in the Road",
      "publishedAt": "2026-04-27T11:30:00.000Z",
      "priceCents": null
    }
    // ...18 more posts
  ]
}

The publication response includes recent posts with slug, title, publishedAt, and priceCents. If priceCents is null, the charged 200 response provides the current price in paymentInfo.amountUsd.

Retrieve an article summary with your API key

Use the publicationSlug and slug from search or publication lookup to call the paid article route. A successful response returns 200 with article metadata and synthesizedSummary. The first successful pay for a post unlocks it forever for this Drip account; later requests for the same post do not spend credits.

Request examples

cURL
JavaScript
Python

export DRIP_API_KEY="pk_drip_YOUR_KEY"
export PUBLICATION_SLUG="unchainedcrypto.beehiiv.com"
export POST_SLUG="defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit"

curl -s \
  "https://dripstack.com/api/v1/publications/$PUBLICATION_SLUG/$POST_SLUG" \
  -H "Authorization: Bearer $DRIP_API_KEY"

const baseUrl = "https://dripstack.com";
const publicationSlug = "unchainedcrypto.beehiiv.com";
const postSlug =
  "defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit";

const response = await fetch(
  `${baseUrl}/api/v1/publications/${publicationSlug}/${postSlug}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.DRIP_API_KEY}`,
    },
  },
);

if (response.status === 403) {
  throw new Error("Insufficient purchased credits. Top up before retrying.");
}

if (!response.ok) {
  throw new Error(`Drip request failed: ${response.status}`);
}

const post = await response.json();
console.log(post.title);
console.log(post.synthesizedSummary);

pip install requests

import os

import requests

base_url = "https://dripstack.com"
publication_slug = "unchainedcrypto.beehiiv.com"
post_slug = (
    "defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit"
)

response = requests.get(
    f"{base_url}/api/v1/publications/{publication_slug}/{post_slug}",
    headers={"Authorization": f"Bearer {os.environ['DRIP_API_KEY']}"},
    timeout=30,
)

if response.status_code == 403:
    raise RuntimeError("Insufficient purchased credits. Top up before retrying.")

response.raise_for_status()

post = response.json()
print(post["title"])
print(post["synthesizedSummary"])

Example response

{
  "publicationSlug": "unchainedcrypto.beehiiv.com",
  "slug": "defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit",
  "title": "DeFi United Unveils Plan to Restore rsETH After $292M Kelp DAO Exploit",
  "author": "Unchained Daily",
  "publishedAt": "2026-04-28T11:00:00.000Z",
  "url": "https://unchainedcrypto.beehiiv.com/p/defi-united-unveils-plan-to-restore-rseth-after-292m-kelp-dao-exploit",
  "synthesizedSummary": "The article explains DeFi United's recovery proposal following the Kelp DAO exploit, including how affected rsETH holders may be made whole...",
  "paymentInfo": {
    "amountUsd": "0.50",
    "protocol": "credits",
    "spendSource": "purchased"
  }
}

The response contains a robust synthesized summary and source metadata. The first successful pay unlocks that post forever for this Drip account; repeating the request for the same post does not spend credits again (paymentInfo.protocol is unlock, and unlocked is true).

Common responses

Status	Meaning	Action
`200`	Summary returned (charged on first unlock)	Use `synthesizedSummary` in research
`401`	Invalid API key	Check the bearer token
`403`	Insufficient credits	Top up purchased credits
`404`	Post or publication missing	Verify `publicationSlug` and `postSlug`
`503`	Summary is not ready	Retry later; no credits were charged

Keep API keys server-side. Do not ship pk_drip_... keys in browser code, public repositories, or agent traces.

Error response examples

An invalid or revoked API key returns:

{
  "error": "Invalid API key."
}

If the summary has not finished processing, no credits are charged:

{
  "error": "Post summary is not ready yet.",
  "code": "summary_not_ready"
}

Get Started

Concepts

Topic Search

Entity Search

Company Lookup

Publications

Top-selling

Stock Picks

Curated Endpoints

Account

Quickstart: API Keys

Request examples

Example response

Common responses

Error response examples

​Request examples

​Example response

​Common responses

​Error response examples

Request examples

Example response

Common responses

Error response examples