Recipes / Follow earnings coverage for a listed company

Follow earnings coverage for a listed company

/stories in keyword mode. The parameters matter less than the reasoning behind them, so that is most of what is below.

The request

GET /stories
  ?q="<TICKER>"
  &mode=keyword
  &from=2026-07-22
  &to=2026-07-29

Why these parameters

One of the few cases where keyword mode is the right answer. Tickers are among the very small set of identifiers publishers render consistently across languages and registers, which is exactly what keyword matching needs and almost never gets. Company names are not: the same firm appears as its registered name, a short form, a local-language rendering or a ticker, sometimes several within one article.

What comes back

Coverage clusters around the announcement. During reporting season this reliably collapses several hundred syndicated items into a readable set of distinct events.

How this goes wrong

Using the company name in keyword mode and concluding coverage is thin. Fall back to hybrid if the ticker is ambiguous — some collide with ordinary words, and a three-letter ticker in keyword mode can return a great deal of nothing.

Adapting it

For a portfolio rather than one company, issue one query per ticker rather than an OR query — you want to attribute results, and a combined query makes that ambiguous. For companies without a liquid listing, fall back to hybrid mode with the registered name, and accept that recall will be lower. Japanese and Korean coverage is a special case: the ticker is often the only stable identifier because the name appears in several scripts.

Running it for real

Reporting season concentrates volume enormously, so budget for a peak that is many times the baseline rather than for the average. Bound queries to the reporting window rather than running a rolling window year-round, which spends most of its requests on quiet periods. If you are computing anything from tone, fix the outlet set first — financial coverage tone varies more by publication than by quarter.

When this is the wrong tool

Ticker matching fails for companies with dual listings, recent symbol changes or listings on exchanges whose codes collide with others. It also fails for anything not publicly listed, which excludes most of the interesting private-market activity. Where the ticker is not usable, hybrid mode on the registered name is the fallback and recall will be materially lower. This recipe is also a poor basis for anything resembling a trading signal: coverage follows announcements rather than preceding them, so what you are measuring is the reporting of a fact that the market already has. Treat it as a monitoring and summarisation tool, not as an information edge.