Skip to main content
GET
Get company news

Authorizations

Authorization
string
header
required

Authenticate using one of two formats:

  • Organization/user token: Token <your-token>
  • Stytch JWT: Bearer <your-jwt>

Query Parameters

company_domain
string

Fetch news for a single company by domain (e.g. openai.com).

company_domains
string

Comma-separated list of company domains (e.g. openai.com,anthropic.com). Max 200.

company_id
integer

Fetch news for a single company by internal ID. Takes highest precedence.

created_at_end
string<date-time>

Filter news created on or before this datetime (ISO 8601). Alias: created_at_lte.

created_at_gte
string<date-time>

Alias for created_at_start.

created_at_lte
string<date-time>

Alias for created_at_end.

created_at_start
string<date-time>

Filter news created on or after this datetime (ISO 8601). Alias: created_at_gte.

news_type
enum<string>

Filter by news importance. Default: major.

Available options:
all,
major
page_after
string

Cursor for forward pagination. Cannot combine with page_before.

page_before
string

Cursor for backward pagination. Cannot combine with page_after.

page_size
integer

Number of results per page. Default: 10, max: 50.

release_date_end
string<date-time>

Filter news released on or before this datetime (ISO 8601).

release_date_start
string<date-time>

Filter news released on or after this datetime (ISO 8601).

require_thumbnails
boolean

When true, articles without thumbnails fall back to the company logo. Default: false.

updated_at_gte
string<date-time>

Filter news updated on or after this datetime (ISO 8601). Recommended for daily polling.

updated_at_lte
string<date-time>

Filter news updated on or before this datetime (ISO 8601). Recommended for daily polling.

Response

Paginated list of company news items.

company_news
object[]
required
meta
object
required
pagination
object
required