> ## 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 `person` / `company` / `organization`,
subject queries do not call Wikidata (`resolved` stays `null`). Same catalog
as topic search (`isCurated`, not disabled). Free, no auth required.

## Request

The endpoint requires at least one of `ticker`, `company`, `person`,
`organization`, or `subject`.

```bash theme={null}
curl "https://dripstack.com/api/v1/entities/search?subject=semiconductors&limit=5"
```

| Parameter                            | Required | Description                                                      |
| ------------------------------------ | -------- | ---------------------------------------------------------------- |
| `subject`                            | yes      | Theme or subject, minimum 2 characters                           |
| `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 |

## Response

```json theme={null}
{
  "query": {
    "ticker": null,
    "company": null,
    "person": null,
    "organization": null,
    "subject": "semiconductors",
    "publicationSlug": null,
    "publishedAfter": null,
    "publishedBefore": null
  },
  "resolved": 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 — use this to browse
a named theme by recency. Broad "what are analysts saying about X?" research
still belongs on `/api/v1/search`.