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

> Find newsletter and podcast articles tagged with a theme or subject.

Use `GET /api/v1/entities/search` with a `subject` to find curated articles
whose extracted themes mention a topic — a case-insensitive substring match
against `metadataJson.themes`. Unlike `ticker` / `person` / `company` /
`organization`, subject-only queries do not fill `matchedEntity`.
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?subject=semiconductors&limit=5"
```

| Parameter | Required | Description |
| - | - | - |
| `subject` | one of | Theme or subject, 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": null,
    "organization": null,
    "subject": "semiconductors",
    "author": null,
    "stockPicksOnly": false,
    "sort": "latest",
    "publicationSlug": null,
    "publishedAfter": null,
    "publishedBefore": null
  },
  "matchedEntity": null,
  "count": 1,
  "nextCursor": null,
  "items": [
    {
      "publicationSlug": "stratechery",
      "slug": "chip-cycle",
      "title": "The Semiconductor Cycle",
      "author": "Ben Thompson",
      "publishedAt": "2026-06-12T00:00:00.000Z",
      "priceCents": 500,
      "url": "https://stratechery.com/p/chip-cycle",
      "isPodcast": false
    }
  ]
}
```

Results are sorted by `publishedAt`, most recent first by default (`sort=latest`).
Use this to browse a named theme by recency. Broad "what are analysts saying about X?" research
still belongs on `/api/v1/search`.


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