--- title: "Discover News Events" method: GET path: "/discover/news_events" tags: ["News Events Dataset"] --- # Discover News Events `GET /discover/news_events` Returns a list of News Events, optionally filtered by categories and company's location, company's size, ordered by the `found_at`, descending. ## Query parameters - `categories` union[] - union - 'acquires' — Company acquired another company.
**Group**: `acquisition`
**Optional `attributes`:** `amount`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'merges_with' — Company merges with another company.
**Group**: `acquisition`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'sells_assets_to' — Company sells assets (like properties or warehouses) to other company.
**Group**: `acquisition`
**Optional `attributes`:** `amount`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'loses_client' — Company loses a client.
**Group**: `contract`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'signs_new_client' — Company signs new client.
**Group**: `contract`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'declares_bankruptcy' — Organization declares bankruptcy.
**Group**: `corporate_challenges`
**Present `attributes`:** `bankruptcy`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'files_suit_against' — Company files suit against other company.
**Group**: `corporate_challenges`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'has_issues_with' — Company has vulnerability problems.
**Group**: `corporate_challenges`
**Present `attributes`:** `vulnerability`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'closes_offices_in' — Company closes existing offices.
**Group**: `cost_cutting`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'decreases_headcount_by' — Company lays off employees.
**Group**: `cost_cutting`
**Present `attributes`:** `headcount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'attends_event' — Company attends an event.
**Group**: `expansion`
**Present `attributes`:** `event`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'expands_facilities' — Company opens new or expands existing facilities like warehouses, data centers, manufacturing plants etc.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'expands_offices_in' — Company expands existing offices.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'expands_offices_to' — Company opens new offices in another town, state, country or continent.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'increases_headcount_by' — Company offers new job vacancies.
**Group**: `expansion`
**Present `attributes`:** `headcount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'opens_new_location' — Company opens new service location like hotels, restaurants, bars, hospitals etc.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'goes_public' — Company issues shares to the public for the first time.
**Group**: `investment`
**Present `attributes`:** `financing_type`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'has_earnings' — Earnings were reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'has_revenue' — Revenue was reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'has_valuation' — Valuation was reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'invests_into' — Company invests into other company.
**Group**: `investment`
**Optional `attributes`:** `amount`, `financing_type`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'invests_into_assets' — Company buys assets (like properties or warehouses) from other company.
**Group**: `investment`
**Present `attributes`:** `assets`
**Optional `attributes`:** `amount`, `location`, `effective_date`
**Present `relationships`:** `company1` - 'receives_financing' — Company receives financing like venture funding, loan, grant etc.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `financing_type`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'hires' — Company hired new executive or senior personnel.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'leaves' — Executive or senior personnel left the company.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company2` - 'promotes' — Company promoted existing executive or senior personnel.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'retires_from' — Executive or senior personnel retire from the company.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company2` - 'integrates_with' — Company integrates with other company.
**Group**: `new_offering`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'is_developing' — Company is developing a new offering.
**Group**: `new_offering`
**Present `attributes`:** `product`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - 'launches' — Company launches new offering.
**Group**: `new_offering`
**Present `attributes`:** `product`
**Optional `attributes`:** `event`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'ends_partnership_with' — Company ends partnership with other company.
**Group**: `partnership`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'partners_with' — Company partners with another company.
**Group**: `partnership`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'receives_award' — Company or person at the company receives an award.
**Group**: `recognition`
**Present `attributes`:** `award`
**Optional `attributes`:** `contact`, `event`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'recognized_as' — Company or person at the company receives recognition.
**Group**: `recognition`
**Present `attributes`:** `recognition`
**Optional `attributes`:** `contact`, `event`, `effective_date`, `location`
**Present `relationships`:** `company1` - 'identified_as_competitor_of' — New or existing competitor was identified.
**Group**: `relational`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'spins_off_company' — Company spins off another company.
**Group**: `relational`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2` - 'spins_off_division' — Company spins off a division.
**Group**: `relational`
**Present `attributes`:** `division`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1` - `company_location` string - `company_sizes` string[] - `page` integer - `limit` integer ## Response `200` Request was successfully processed. - NewsEventsDataset — Since 2016, PredictLeads has detected over 9 million relevant news signals, which are available for 2.4 million companies globally.

The News Events are sourced from some 20 million blogs, news and PR sites and distilled into relevant categories by machine learning algorithms.

The News Events dataset includes fields such as Formatted Signal, Signal Category, Most Relevant Source URL, Article Sentence, Article Body, Article Author, Found At, Effective Date and other News Event information. - `data` NewsEvent[], required — unresolved $ref - `included` union[], required — Contains objects referenced in property `relationships`. - union - CompanyLite — unresolved $ref - NewsArticleLite — unresolved $ref - `meta` object — Meta information about `NewsEventsDataset` object. - `schema_version` string, required — Represents schema version of objects. - `record_state` 'active', required — Represents record state of objects. - `count` integer — Total number of results.
**NOTE**: Only included in API responses when the request parameter `page` is provided, for performance reasons. ## Other responses - `400` — Invalid request body or parameters. - `401` — Authentication credentials are invalid or API subscription is not activated. - `402` — Exceeded the monthly request limit. - `403` — Request rate over limit. - `404` — Record not found. - `422` — Provided data failed to validate. - `429` — Too many requests. - `500` — Internal server error. - `503` — Service temporarily unavailable. --- [API](https://skmtc.dev/predictleads/apis/predictleads-api-reference.md) · [All operations](https://skmtc.dev/predictleads/apis/predictleads-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/predictleads/predictleads-api-reference/revisions/a56831a1efd4/schema)