# PredictLeads Get Company News Events

> PredictLeads Get Company News Events is a paid API for AI agents from agents.predictleads.com, paid per call via MPP, $0.040000/call, status healthy (last checked 2026-10-30, last successful call 2026-10-27).

Returns a paginated list of structured news events for a specific company, categorized by event type such as acquisitions, headcount changes, product launches, and more.

## Facts

- Endpoint: GET https://agents.predictleads.com/api/v3/companies/{company_id_or_domain}/news_events?utm_source=zero.xyz
- Price: $0.040000/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-30
- Last successful call: 2026-10-27
- Activations on Zero: 1
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-predictleads-get-company-news-events-7f2dc378
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j5Ezfo8AnQ6kQ9L_tpvwl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-predictleads-com-predictleads-get-company-news-events-7f2dc378
```

Example prompt: Pull all news events for salesforce.com from PredictLeads for the past 6 months, filtered to acquisition and partnership categories — I want to see who they've been acquiring and partnering with.

## When to prefer this

Use this endpoint when you need structured, categorized news intelligence about a specific company — especially for sales trigger detection, competitive monitoring, M&A tracking, or workforce change signals. It is preferable over generic web search when you need machine-readable, confidence-scored, dated events with consistent taxonomy across 120M+ companies. Choose this over the Financing Events endpoint when you need broader news coverage beyond funding rounds.

## Known failure modes

- Invalid or unknown company_id_or_domain returns empty data array or 404
- Invalid category enum value causes 400 bad request
- Invalid date format for found_at_from or found_at_until causes 400 bad request
- Omitting the page parameter causes the meta.count field to be omitted from the response
- Requesting beyond available pages returns an empty data array
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Returns a list of company's News Events.

## Output

A JSON object containing a `data` array of news event objects, each with an ID, category, summary, headline, found_at timestamp, effective_date, location, confidence score, optional numeric fields (headcount, amount), and relationship references to the company and source news article. A `meta` object includes record_state and schema_version, and optionally a `count` when pagination is used. An `included` array provides resolved company and news article records.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "company_id_or_domain"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n"
  },
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 1000,
   "description": "Limit the number of shown items per page."
  },
  "location": {
   "type": "string",
   "example": "United States",
   "description": "The response will include only results in the given country name or state name/abbreviation.\n"
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string",
    "oneOf": [
     {
      "const": "acquires",
      "description": "Company acquired another company.\n<br>**Group**: `acquisition`\n<br>**Optional <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes\">`attributes`</a>:** <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes/amount\">`amount`</a>, <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes/effective_date\">`effective_date`</a>, <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes/location\">`location`</a>\n<br>**Present <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/relationships\">`relationships`</a>:** <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/relationships/company1\">`company1`</a>, <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/relationships/company2\">`company2`</a>"
     },
     {
      "const": "merges_with",
      "description": "Company merges with another company.\n<br>**Group**: `acquisition`\n<br>**Optional <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes\">`attributes`</a>:** <a href=\"https://docs.predictleads.com/guide/news_events_dataset/data_model/news_events_dataset/data/news_event/attributes/effective_date\">`effective_date`</a>, <a href=\"https://docs.predictleads.com/guide/news_events_dataset/da
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "NewsEventsDataset",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "data": [
   {
    "id": "e120b1e6-0270-4cdd-913d-d037ef9da422",
    "type": "news_event",
    "attributes": {
     "award": null,
     "event": null,
     "amount": null,
     "assets": null,
     "contact": null,
     "product": null,
     "summary": "On Oct 20th '26, Amazon.com Inc. aims to add 300000 seasonal workers to its fulfillment and transportation network across the United States during the holiday rush, up from 250,000 in each of the prior three years.",
     "category": "increases_headcount_by",
     "division": null,
     "found_at": "2026-10-20T00:00:00Z",
     "headline": "Amazon.com Inc. aims to increase its seasonal workforce by 300000 in the United States on Oct 20th '26",
     "location": "United States, Northern America, Americas",
     "planning": true,
     "headcount": 300000,
     "job_title": null,
     "confidence": 1,
     "assets_tags": [],
     "recognition": null,
     "product_data": {
      "name": null,
      "full_text": null,
      "fuzzy_match": null,
      "release_type": null,
      "release_version": null
     },
     "product_tags": [],
     "first_seen_at": "2026-10-20T14:44:30Z",
     "location_data": [
      {
       "city": null,
       "state": null,
       "region": "Northern America",
       "country": "United States",
       "zip_code": null,
       "continent": "Americas",
       "fuzzy_match": false
      }
     ],
     "vulnerability": null,
     "effective_date": "2026-10-20",
     "financing_type": null,
     "job_title_tags": [],
     "article_sentence": "Amazon aims to add 300,000 seasonal workers - and expands health benefits in the new year.",
     "amount_normalized": null,
     "company1_importance": "high",
     "company2_importance": null,
     "financing_type_tags": [],
     "financing_type_normalized": null
    },
    "relationships": {
     "company1": {
      "data": {
       "id": "c9b92ffd-a2ed-5787-8b06-f4bf8d291e57",
       "type": "company"
      }
     },
     "most_relevant_source": {
      "data": {
       "id": "d7dbb269-ada6-4300-8578-d7b23332049f",
       "type": "news_article"
      }
     }
    }
   }
  ],
  "meta": {
   "record_state": "active",
   "schema_version": "3.3"
  },
  "included": [
   {
    "id": "c9b92ffd-a2ed-5787-8b06-f4bf8d291e57",
    "type": "company",
    "attributes": {
     "domain": "amazon.com",
     "ticker": "NASDAQ:AMZN",
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-predictleads-com-predictleads-get-company-news-events-7f2dc378/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.predictleads.com](https://www.zero.xyz/host/agents.predictleads.com/llms.txt)