Find articles that mention a ticker, company, person, organization, or subject.
Sorted by publish date (most recent first) — use this to answer “what did analysts say about X this week?” rather than /api/v1/search’s topic-relevance ranking. Person, company, and organization queries may expand to related employers and tickers, then match existing post metadata tags. Limited to curated, non-disabled publications, same catalog as topic search.
Query Parameters
Stock ticker, 1-8 characters (letters, numbers, . or -). At least one of ticker, company, person, organization, or subject is required.
1 - 8^[A-Za-z0-9.-]+$Company name, matched as a case-insensitive substring and expanded to related tickers when known.
2Person name. Matches tagged persons, related companies/tickers, and titles.
2Organization name. Matches companies and themes; expands to related companies/tickers when possible.
2Theme or subject discussed in posts, matched against metadata themes.
2Restrict results to one publication.
Inclusive UTC calendar day lower bound, YYYY-MM-DD.
Inclusive UTC calendar day upper bound, YYYY-MM-DD.
Maximum number of items returned (1-30).
1 <= x <= 30Pass the previous response's nextCursor to fetch the next page.
Response
Matched articles, most recent first.
The person, company, or organization matched from the query, including related companies, tickers, and how posts were searched. Null for ticker-only queries or when no match was found.
Deprecated alias of matchedEntity. Same value; keep reading matchedEntity.
Number of items in this page.
x >= 0Pass to the cursor param to fetch the next page; null when no more results.

