Skip to main content
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.
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

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.