# PredictLeads Discover News Events

> PredictLeads Discover News Events is a paid API for AI agents from agents.predictleads.com, paid per call via MPP, $1.2/call (dynamic — varies by input), status unknown (last checked 2026-10-30).

Returns a paginated, filterable feed of company news events (acquisitions, funding, hiring, product launches, etc.) across 120M+ companies, sorted by recency.

## Facts

- Endpoint: GET https://agents.predictleads.com/api/v3/discover/news_events?utm_source=zero.xyz
- Price: $1.2/call (dynamic — varies by input)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-predictleads-discover-news-events-86ae5508
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A6ZUsUQqatygyVGUC3SQT

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-discover-news-events-86ae5508
```

Example prompt: Pull the latest 50 acquisition and merger news events from PredictLeads for companies located in the United States — I want to see what M&A activity has been happening recently.

## When to prefer this

Use this endpoint when you need a broad, cross-company feed of news events rather than events for a single known company. It is the right choice for market monitoring, lead generation triggers, competitive intelligence sweeps, and building alerts across categories and geographies. Prefer the company-specific 'Get News Events' endpoint when you already know the target company's domain and want only their events.

## Known failure modes

- Invalid category enum value returns a validation error
- Exceeding limit of 1000 per page returns an error
- Omitting page parameter omits the count field from meta (by design, not an error)
- Empty result set returned if no events match the given location or size filters
- Authentication or payment failure returns an authorization error

## How this service works

Returns a list of News Events, optionally filtered by categories and company's location, company's size, ordered by the `found_at`, descending.

## Output

A paginated JSON array of news event objects, each containing: event category (e.g. 'acquires', 'increases_headcount_by', 'launches_product'), a plain-English summary and headline, the date found and effective date, confidence score, optional amount/headcount/location attributes, and relationships to the involved company and source news article. Included sidecar objects provide company domain, ticker, and name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "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": 30,
   "maximum": 1000,
   "description": "Limit the number of shown items per page."
  },
  "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/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\">`relati
… (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-discover-news-events-86ae5508/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)