Skip to main content
GET
Find articles that mention an entity or are linked to a stock pick.

Query Parameters

ticker
string

Stock ticker, 1-8 characters (letters, numbers, . or -). Normally resolves a company card and expands to company-name tags. With stockPicksOnly=true, matches StockPickCall.ticker exactly without metadata ticker expansion. At least one of ticker, company, person, organization, subject, or author is required.

Required string length: 1 - 8
Pattern: ^[A-Za-z0-9.-]+$
company
string

Company name, matched as a case-insensitive substring and expanded to related tickers when known.

Minimum string length: 2
person
string

Person name. Matches tagged persons, related companies/tickers, and titles.

Minimum string length: 2
organization
string

Organization name. Matches companies and themes; expands to related companies/tickers when possible.

Minimum string length: 2
subject
string

Theme or subject discussed in posts, matched against metadata themes.

Minimum string length: 2
author
string

Canonical source article/pick author, matched as a case-insensitive substring. Can be used alone for stock-pick-only discovery.

Minimum string length: 2
stockPicksOnly
boolean
default:false

When true, return only free article results linked to at least one stock-pick row.

sort
enum<string>
default:latest

Publication ordering. latest is most recent first; earliest is oldest first.

Available options:
latest,
earliest
publicationSlug
string

Restrict results to one publication.

publishedAfter
string<date>

Inclusive UTC calendar day lower bound, YYYY-MM-DD.

publishedBefore
string<date>

Inclusive UTC calendar day upper bound, YYYY-MM-DD.

limit
integer
default:10

Maximum number of items returned (1-30).

Required range: 1 <= x <= 30
cursor
string

Pass the previous response's nextCursor to fetch the next page.

Response

Matched articles, sorted by publication date.

query
object
required
matchedEntity
object | null
required

The person, company, or organization matched from the query, including related companies, tickers, and how posts were searched. Null when no match was found.

count
integer
required

Number of items in this page.

Required range: x >= 0
nextCursor
string | null
required

Pass to the cursor param to fetch the next page; null when no more results.

items
object[]
required