> ## 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. # Get company news > Returns news items for one or more companies with cursor-based pagination. **Company filter precedence:** `company_id` > `company_domains` > `company_domain`. If none are provided (domain-less query), at least one date range spanning 14 days or less is required. **Limits:** Up to 200 company domains. ## OpenAPI ````yaml GET /api/v1/news/company/ openapi: 3.0.3 info: title: Sacra API version: 1.0.0 description: >- The Sacra API currently supports querying News, Documents, Companies and Categories that enable you to use Sacra research within your own application. ## **Getting started guide** To start using the APIs, you need to: - Only available to **Platforms** and **Funds** tier members. (See [here](https://sacra.com/pricing/)) - You must use a valid API Key to send requests to the API endpoints. You can generate your API key in the Api Keys section of your [Organization Settings](https://sacra.com/orgs/settings/general/). - The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key. ## Authentication The Sacra API uses Tokens for authentication. You can generate a Sacra API Key/Token in the Api Keys section of your [Organization Settings](https://sacra.com/orgs/settings/general/). You must include an API Key/Token in each request to the Sacra API with the **Authorization** request header. ### Authentication error response If a Token is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code. ### **Need some help?** In case you have questions, we will eventually provide tutorials and a FAQ page. But for now you can check out the [#developers](https://discord.gg/mTswyV8gg3) channel in our community [Discord](https://discord.gg/mTswyV8gg3), there’s a good chance our community has an answer for you. ## Authorization | **Key** | **Value** | | --- | --- | | Authorization | Token {{API_KEY}} | servers: - url: https://sacra.com description: Production security: [] tags: - name: Companies - name: Categories - name: Events - name: News - name: Documents - name: Filings - name: Embeds - name: Metrics - name: Funding (Legacy) paths: /api/v1/news/company/: get: tags: - News summary: Get company news description: >- Returns news items for one or more companies with cursor-based pagination. **Company filter precedence:** `company_id` > `company_domains` > `company_domain`. If none are provided (domain-less query), at least one date range spanning 14 days or less is required. **Limits:** Up to 200 company domains. operationId: news_company_retrieve parameters: - in: query name: company_domain schema: type: string description: Fetch news for a single company by domain (e.g. `openai.com`). - in: query name: company_domains schema: type: string description: >- Comma-separated list of company domains (e.g. `openai.com,anthropic.com`). Max 200. - in: query name: company_id schema: type: integer description: >- Fetch news for a single company by internal ID. Takes highest precedence. - in: query name: created_at_end schema: type: string format: date-time description: >- Filter news created on or before this datetime (ISO 8601). Alias: `created_at_lte`. - in: query name: created_at_gte schema: type: string format: date-time description: Alias for `created_at_start`. - in: query name: created_at_lte schema: type: string format: date-time description: Alias for `created_at_end`. - in: query name: created_at_start schema: type: string format: date-time description: >- Filter news created on or after this datetime (ISO 8601). Alias: `created_at_gte`. - in: query name: news_type schema: type: string enum: - all - major description: 'Filter by news importance. Default: `major`.' - in: query name: page_after schema: type: string description: Cursor for forward pagination. Cannot combine with `page_before`. - in: query name: page_before schema: type: string description: Cursor for backward pagination. Cannot combine with `page_after`. - in: query name: page_size schema: type: integer description: 'Number of results per page. Default: 10, max: 50.' - in: query name: release_date_end schema: type: string format: date-time description: Filter news released on or before this datetime (ISO 8601). - in: query name: release_date_start schema: type: string format: date-time description: Filter news released on or after this datetime (ISO 8601). - in: query name: require_thumbnails schema: type: boolean description: >- When true, articles without thumbnails fall back to the company logo. Default: false. - in: query name: updated_at_gte schema: type: string format: date-time description: >- Filter news updated on or after this datetime (ISO 8601). Recommended for daily polling. - in: query name: updated_at_lte schema: type: string format: date-time description: >- Filter news updated on or before this datetime (ISO 8601). Recommended for daily polling. responses: '200': content: application/json: schema: $ref: '#/components/schemas/CompanyNewsGetResponse' examples: SingleCompanyNews: value: 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: >- https://sacra.com/api/v1/news/company/?company_domain=stripe.com&page_after=abc124 prev_link: null next_cursor: abc124 prev_cursor: null after_cursor: null before_cursor: null MultiCompanyNews: value: company_news: - id: 6c5c4ff4-06a1-4417-8908-6811f3d755cc release_date: '2026-03-04T12:00:53Z' headline: >- Polymarket Launches 12+ Iran-Related Contracts as Bets Spike short_headline: Polymarket Opens 12+ description: >- Polymarket's rollout of 12+ Iran-related contracts broadens geopolitical wagering, driving user engagement and attracting regulatory scrutiny amid record betting volume. created_at: '2026-03-05T14:16:07.576136Z' updated_at: '2026-03-05T14:16:07.576145Z' articles: - id: 01475fde-cab5-4dc6-8f59-cfca8aa6c12a link: >- https://www.bloomberg.com/news/articles/2026-03-04/prediction-markets-roll-out-new-war-bets-beyond-washington-reach headline: >- Prediction Markets Roll Out New War Bets Beyond Washington's Reach short_summary: >- Polymarket opened more than a dozen new contracts tied to the Iran conflict. date_published: '2026-03-04T12:00:53Z' thumbnail: null publication: Bloomberg publication_score: 200 company: id: 1553 domain: polymarket.com meta: query_type: multi-company companies_count: 2 companies: - id: 1553 domain: polymarket.com - id: 1494 domain: kalshi.com pagination: page_size: 10 current_page_items: 10 total_items: 177 next_link: >- https://sacra.com/api/v1/news/company/?company_domains=polymarket.com%2Ckalshi.com&page_after=33914659-b6bb-458e-9983-ecb70b2e1f61 prev_link: null next_cursor: 33914659-b6bb-458e-9983-ecb70b2e1f61 prev_cursor: null after_cursor: null before_cursor: null description: >- Multi-company query using company_domains. Shows pagination with next_link. DailyPollingNews: value: company_news: - id: 997bdd91-ec86-4f54-ac46-671eb50ec214 release_date: '2026-01-13T10:37:38Z' headline: >- Balderton Capital Cashes Out $2 Billion From Revolut Stake short_headline: Balderton Cashes $2B description: >- It led Revolut's first funding round and has cashed out about $2bn while retaining a substantial stake in the fintech now valued at roughly $75bn. created_at: '2026-01-13T12:24:06.621470Z' updated_at: '2026-01-13T12:24:06.621479Z' articles: - id: 0681f131-b451-43d6-a3f6-c857060021ee link: >- https://ft.com/content/e19a419f-5c81-4326-8f41-478e90c7211a headline: The London investor making billions from Revolut short_summary: >- The VC firm Balderton Capital is cashing in on its home-run bet on the fintech date_published: '2026-01-14T05:00:31Z' thumbnail: null publication: Financial Times publication_score: 200 company: id: 407 domain: revolut.com meta: query_type: domain-less companies_count: 1 companies: - id: 407 domain: revolut.com pagination: page_size: 10 current_page_items: 7 total_items: 7 next_link: null prev_link: null next_cursor: null prev_cursor: null after_cursor: Start before_cursor: null description: >- Domain-less query using updated_at_gte/updated_at_lte for daily polling. Note meta.companies is null for domain-less queries. CursorPagination: value: company_news: - id: 4b81b067-7392-415b-8b24-41cfe6b585a3 release_date: '2023-08-09T04:56:00Z' headline: >- Leap Event Technology Launches Integrated Merchant Services Solution Powered by Stripe short_headline: null description: >- Leap Event Technology's new integrated merchant services solution, powered by Stripe, aims to streamline transaction infrastructure and services for enterprise ticketing and e-commerce products. created_at: '2023-11-16T09:40:07.631879Z' updated_at: '2023-12-09T00:51:49.027687Z' articles: - id: 2d476547-7809-4b75-9c23-c5759d0a9df6 link: >- https://www.prnewswire.com/in/news-releases/leap-event-technology-launches-integrated-merchant-services-solution-301896565.html headline: >- LEAP EVENT TECHNOLOGY LAUNCHES INTEGRATED MERCHANT SERVICES SOLUTION short_summary: >- Leap Event Technology has launched an integrated merchant services solution powered by Stripe. date_published: '2023-08-09T04:56:00Z' thumbnail: null publication: PR Newswire publication_score: 100 company: id: 112 domain: stripe.com meta: query_type: single-company companies_count: 1 companies: - id: 112 domain: stripe.com pagination: page_size: 10 current_page_items: 10 total_items: 242 next_link: >- https://sacra.com/api/v1/news/company/?company_domain=stripe.com&page_size=10&page_after=fc9e42c8-038e-4f2e-8abc-5d3b63e62128 prev_link: >- https://sacra.com/api/v1/news/company/?company_domain=stripe.com&page_size=10&page_before=4b81b067-7392-415b-8b24-41cfe6b585a3 next_cursor: fc9e42c8-038e-4f2e-8abc-5d3b63e62128 prev_cursor: 4b81b067-7392-415b-8b24-41cfe6b585a3 after_cursor: a0b4983c-ff37-40f2-8dee-6a7889ae1911 before_cursor: null description: >- Paginated result using page_after cursor. Shows both next_link and prev_link populated (mid-stream pagination). Use after_cursor/before_cursor values with page_after/page_before params to navigate. ReleaseDateFilter: value: company_news: - id: 3ca0520a-3cc6-46dd-83c0-cfdf8996b916 release_date: '2023-01-02T04:56:00Z' headline: >- Applied Intuition Partners with Ambarella to Offer Advanced ADAS and AV Development Solution short_headline: Applied Intuition partners Ambarella. description: >- Applied Intuition's partnership with Ambarella will bring cutting-edge technology to the development of autonomous driving systems. created_at: '2024-03-15T23:48:09.630148Z' updated_at: '2024-03-15T23:53:30.631035Z' articles: - id: 9616fa35-bde8-4dc8-897e-84f94405d407 link: >- https://www.globenewswire.com/news-release/2023/01/02/2581526/23306/en/Ambarella-Partners-With-Applied-Intuition.html headline: >- Ambarella Partners With Applied Intuition to Offer Scalable HIL Testing for CV3-AD Domain Controller SoCs short_summary: >- Applied Intuition partners with Ambarella to offer a joint ADAS and AV development solution for autonomous vehicle testing. date_published: '2023-01-02T04:56:00Z' thumbnail: null publication: GlobeNewswire publication_score: 100 company: id: null domain: appliedintuition.com meta: query_type: single-company companies_count: 1 companies: - id: null domain: appliedintuition.com pagination: page_size: 10 current_page_items: 1 total_items: 1 next_link: null prev_link: null next_cursor: null prev_cursor: null after_cursor: Start before_cursor: null description: >- Filtered by release_date_start and release_date_end (URL-encoded ISO 8601 datetimes). Returns only news items with release_date within the specified range. CreatedAtFilter: value: company_news: - id: 2e1df7d7-9dc5-4054-9093-1453902eaf1d release_date: '2024-02-21T07:32:33.067727Z' headline: >- Scale AI Partners with Pentagon to Develop Testing Framework for Large Language Models in Military Applications short_headline: Scale AI partners Pentagon. description: >- Scale AI's collaboration with the Pentagon highlights the growing importance of ethical considerations in the development of large language models for military use. created_at: '2024-02-24T07:32:59.254597Z' updated_at: null articles: - id: 17b50ca7-55b8-4bc5-8773-363ce513b099 link: >- https://defensescoop.com/2024/02/20/scale-ai-pentagon-testing-evaluating-large-language-models/ headline: >- Scale AI to set the Pentagon's path for testing and evaluating large language models short_summary: >- Scale AI partners with the Pentagon to develop a test-and-evaluation framework for large language models in military applications. date_published: '2024-02-21T07:32:33.067727Z' thumbnail: null publication: DefenseScoop publication_score: 0 company: id: null domain: scale.com - id: 87eda107-9ac1-40d0-83be-f7d35b8d8d93 release_date: '2024-01-31T07:18:21.520819Z' headline: >- Scale AI Expands Expert Roles for AI Training Data with Remotasks Subsidiary short_headline: null description: >- Scale AI's acquisition of Remotasks will likely lead to increased opportunities for experts in AI training data. created_at: '2024-02-03T07:18:52.662047Z' updated_at: null articles: - id: 47e3ce5b-5e3f-4cc3-9b38-24ddf8f77fa2 link: https://www.pcguide.com/ai/what-is-scale-ai/ headline: >- What is Scale AI? - The Generative AI Data Engine powering LLMs short_summary: >- Scale AI is a San Francisco-based company founded in 2016 that offers a generative AI platform for accelerating the development of AI applications. date_published: '2024-01-31T07:18:21.520819Z' thumbnail: null publication: PC Guide publication_score: 0 company: id: null domain: scale.com meta: query_type: single-company companies_count: 1 companies: - id: null domain: scale.com pagination: page_size: 10 current_page_items: 2 total_items: 2 next_link: null prev_link: null after_cursor: Start before_cursor: null description: >- Filtered by created_at_start and created_at_end (ISO 8601 datetimes). Returns news items created within the specified range. Note: created_at reflects when Sacra ingested the news, which may differ from release_date. EmptyResults: value: company_news: [] meta: query_type: single-company companies_count: 0 companies: [] pagination: null description: Paginated list of company news items. '400': content: text/plain: schema: type: string example: 'Invalid domain(s): notadomain' description: >- Invalid parameters. Possible reasons: bad JSON body, invalid domain, invalid page_size, both page_after and page_before provided, malformed dates, date range exceeds 14 days for domain-less queries, or too many company domains. '404': content: text/plain: schema: type: string example: 'Companies not found for domain(s): johncena.com' description: Company or cursor not found. security: - SacraAPIAuthentication: [] components: schemas: CompanyNewsGetResponse: type: object properties: company_news: type: array items: $ref: '#/components/schemas/CompanyNewsItem' meta: $ref: '#/components/schemas/CompanyNewsMeta' pagination: $ref: '#/components/schemas/CompanyNewsPagination' required: - company_news - meta - pagination CompanyNewsItem: type: object properties: id: type: string release_date: type: string nullable: true headline: type: string short_headline: type: string nullable: true description: type: string nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time articles: type: array items: $ref: '#/components/schemas/CompanyNewsArticle' company: $ref: '#/components/schemas/CompanyNewsCompanyRef' required: - articles - company - created_at - description - headline - id - release_date - short_headline - updated_at CompanyNewsMeta: type: object properties: query_type: type: string description: One of `single-company`, `multi-company`, `domain-less`. companies_count: type: integer companies: type: array items: $ref: '#/components/schemas/CompanyNewsMetaCompany' required: - companies - companies_count - query_type CompanyNewsPagination: type: object properties: page_size: type: integer current_page_items: type: integer total_items: type: integer next_link: type: string nullable: true prev_link: type: string nullable: true next_cursor: type: string nullable: true prev_cursor: type: string nullable: true after_cursor: type: string nullable: true before_cursor: type: string nullable: true required: - after_cursor - before_cursor - current_page_items - next_cursor - next_link - page_size - prev_cursor - prev_link - total_items CompanyNewsArticle: type: object properties: id: type: string link: type: string headline: type: string short_summary: type: string nullable: true date_published: type: string nullable: true thumbnail: type: string nullable: true publication: type: string nullable: true publication_score: type: integer nullable: true required: - date_published - headline - id - link - publication - publication_score - short_summary - thumbnail CompanyNewsCompanyRef: type: object properties: id: type: integer domain: type: string required: - domain - id CompanyNewsMetaCompany: type: object properties: id: type: integer domain: type: string required: - domain - id securitySchemes: SacraAPIAuthentication: type: apiKey in: header name: Authorization description: |- Authenticate using one of two formats: - **Organization/user token:** `Token ` - **Stytch JWT:** `Bearer ` ````