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