Docs · methods

News

News articles collected for a project's tracked competitors, newest first, each with its source url and publish date.

get_news

01

Get competitor news

get_newsread

The news collected for a project, newest first. Pass competitorId to narrow to one company. Only tracked competitors are covered; list_competitors shows which are tracked.

Parameters7

  • projectIdintegerRequiredProject id from list_projects. Every scoped method needs it.
  • competitorIdintegerOptionalCompetitor id from list_competitors. Omit to cover every tracked competitor in the project.
  • fromISO dateOptionalOnly items published on or after this date, e.g. 2026-08-01.
  • toISO dateOptionalOnly items published on or before this date.
  • categorystringOptionalKeep only articles carrying this category tag.
  • limitintegerOptionalRows to return. Defaults to 20, clamped to 100.
  • cursorstringOptionalnextCursor from the previous page of this same method.

Returns4

  • projectNamestring
  • items[]articletitle, summary, sourceUrl, publishedAt, categories, competitorName, competitorUrl.
  • nextCursorstring | nullPass back as cursor to read the next page. Null when done.
  • hasMoreboolean
← Tracked accountsReviews →