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

# Search Articles by Person

> Find newsletter and podcast articles that mention a person.

Use `GET /api/v1/entities/search` with a `person` to find curated articles
that mention someone by name. Person queries expand to related employers and
tickers when known, then match tagged `persons` on post metadata plus related
companies/tickers and the person's name in titles. Limited to enabled
publications curated for chat. Free, no auth required.

## Request

The endpoint requires at least one of `ticker`, `company`, `person`,
`organization`, `subject`, or `author`. Multiple entity inputs are matched
as alternatives; `author` and the other filters narrow the results.

```bash theme={null}
curl "https://dripstack.com/api/v1/entities/search?person=Warren%20Buffett&limit=5"
```

| Parameter | Required | Description |
| - | - | - |
| `person` | one of | Person name, minimum 2 characters |
| `author` | one of | Source article author, minimum 2 characters, matched as a case-insensitive substring |
| `stockPicksOnly` | optional | `true` or `false` (default); only return articles linked to a stock pick when true |
| `sort` | optional | `latest` (default) or `earliest`, ordered by publication date |
| `publicationSlug` | optional | Restrict results to one publication |
| `publishedAfter` / `publishedBefore` | optional | `YYYY-MM-DD`, inclusive UTC calendar day bounds |
| `limit` | optional | 1-30, defaults to 10 |
| `cursor` | optional | Pass the previous response's `nextCursor` to fetch the next page |

Set `sort=earliest` for oldest first. Keep the same filters and sort when
following `nextCursor`. Invalid parameters, reversed date bounds, or an invalid
cursor return `400`.

## Response

```json theme={null}
{
  "query": {
    "ticker": null,
    "company": null,
    "person": "Warren Buffett",
    "organization": null,
    "subject": null,
    "author": null,
    "stockPicksOnly": false,
    "sort": "latest",
    "publicationSlug": null,
    "publishedAfter": null,
    "publishedBefore": null
  },
  "matchedEntity": {
    "kind": "person",
    "name": "Warren Buffett",
    "description": "American investor",
    "companies": [{ "name": "Berkshire Hathaway", "ticker": "BRK.B" }],
    "tickers": ["BRK.B"],
    "matchedVia": ["ticker", "company", "person", "title"]
  },
  "count": 1,
  "nextCursor": null,
  "items": [
    {
      "publicationSlug": "stratechery",
      "slug": "buffett-letter",
      "title": "Warren Buffett's Annual Letter",
      "author": "Ben Thompson",
      "publishedAt": "2026-02-22T00:00:00.000Z",
      "priceCents": 500,
      "url": "https://stratechery.com/p/buffett-letter",
      "isPodcast": false
    }
  ]
}
```

Results are sorted by `publishedAt`, most recent first by default (`sort=latest`).
`matchedEntity` is the person card used for search. It is `null` when expansion misses; the
raw person string is still matched against tagged `persons` and titles in
that case.


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