News Articles Search

post

https://api.apollo.io/api/v1/news_articles/search

Endpoint essentials
API key access	`api/v1/news_articles/search` or `Master API key`
OAuth scopes	`organizations_news_articles`
Credit usage	`1 credit per page`
This endpoint consumes 1 Apollo credit per page, with up to 25 results per page. Learn more about API pricing and credits.

News includes articles related to companies in Apollo.

Use the News Articles Search endpoint to find news articles related to specific companies. Several filters are available to help narrow your search.

Query Params

organization_ids[]

array of strings

required

The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID.

To find IDs, call the Organization Search endpoint and identify the values for organization_id.

Example: 5e66b6381e05b4008c8331b8

organization_ids[]*

categories[]

array of strings

Filter your search to include only certain categories or sub-categories of news. Use the News search filter for companies within Apollo to uncover all possible categories and sub-categories.

Examples: hires; investment; contract

categories[]

published_at[min]

date

Set the lower bound of the date range you want to search.

Use this parameter in combination with the published_at[max] parameter. This date should fall before the published_at[max] date.

The date should be formatted as YYYY-MM-DD.

Example: 2025-02-15

published_at[max]

date

Set the upper bound of the date range you want to search.

Use this parameter in combination with the published_at[min] parameter. This date should fall after the published_at[min] date.

The date should be formatted as YYYY-MM-DD.

Example: 2025-05-15

page

integer

The page number of the Apollo data that you want to retrieve.

Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint.

Example: 4

per_page

integer

The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance.

Use the page parameter to search the different pages of data.

Example: 10

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

200

401Unauthorized

422Unprocessable Entity