Skip to main content
POST
/
api
/
v1
/
news
/
company
Get company news (batch)
curl --request POST \
  --url https://sacra.com/api/v1/news/company/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": 123,
  "company_domain": "<string>",
  "company_domains": [
    "<string>"
  ],
  "news_type": "major",
  "page_size": 123,
  "page_after": "<string>",
  "page_before": "<string>",
  "created_at_start": "2023-11-07T05:31:56Z",
  "created_at_end": "2023-11-07T05:31:56Z",
  "created_at_gte": "2023-11-07T05:31:56Z",
  "created_at_lte": "2023-11-07T05:31:56Z",
  "updated_at_gte": "2023-11-07T05:31:56Z",
  "updated_at_lte": "2023-11-07T05:31:56Z",
  "release_date_start": "2023-11-07T05:31:56Z",
  "release_date_end": "2023-11-07T05:31:56Z",
  "require_thumbnails": false
}
'
{
  "company_news": [
    {
      "id": "440d9f52-275a-4d39-973f-e780a76a9bf6",
      "release_date": "2026-03-02T23:18:27Z",
      "headline": "Stripe Releases 1 Preview to Monetize AI Model Costs",
      "short_headline": "Stripe Preview",
      "description": "Stripe's preview lets AI companies track, pass through and mark up underlying model usage fees.",
      "created_at": "2026-03-03T15:17:46.635681Z",
      "updated_at": "2026-03-03T15:17:46.635689Z",
      "articles": [
        {
          "id": "66348676-99ee-4f5b-8d5a-61b1ae64af6e",
          "link": "https://techcrunch.com/2026/03/02/stripe-wants-to-turn-your-ai-costs-into-a-profit-center",
          "headline": "Stripe wants to turn your AI costs into a profit center",
          "short_summary": "Stripe launched a preview tool for monetizing AI model costs.",
          "date_published": "2026-03-02",
          "thumbnail": "https://techcrunch.com/wp-content/uploads/example.jpg",
          "publication": "TechCrunch",
          "publication_score": 500
        }
      ],
      "company": {
        "id": 42,
        "domain": "stripe.com"
      }
    }
  ],
  "meta": {
    "query_type": "single-company",
    "companies_count": 1,
    "companies": [
      {
        "id": 42,
        "domain": "stripe.com"
      }
    ]
  },
  "pagination": {
    "page_size": 10,
    "current_page_items": 1,
    "total_items": 25,
    "next_link": null,
    "prev_link": null,
    "next_cursor": "abc124",
    "prev_cursor": null,
    "after_cursor": null,
    "before_cursor": null
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sacra.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate using one of two formats:

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

Body

​
company_id
integer

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

​
company_domain
string

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

​
company_domains
string[]

List of company domains (up to 1,000).

​
news_type
enum<string>

Filter by news importance. Default: major.

  • major - major
  • all - all
Available options:
major,
all
​
page_size
integer

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

​
page_after
string

Cursor for forward pagination.

​
page_before
string

Cursor for backward pagination.

​
created_at_start
string<date-time>

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

​
created_at_end
string<date-time>

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

​
created_at_gte
string<date-time>

Alias for created_at_start.

​
created_at_lte
string<date-time>

Alias for created_at_end.

​
updated_at_gte
string<date-time>

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

​
updated_at_lte
string<date-time>

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

​
release_date_start
string<date-time>

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

​
release_date_end
string<date-time>

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

​
require_thumbnails
boolean
default:false

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

Response

Paginated list of company news items. Same shape as GET.

​
company_news
object[]
required
​
meta
object
required
​
pagination
object
required