News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.
News API is a simple HTTP REST API for searching and retrieving live articles from all over the web. On Nagent, NewsAPI is exposed as a fully-configurable news & lifestyle integration that any agent can call — 4 actions, and API key authentication. No code is required to wire NewsAPI into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use NewsAPI to automate the kinds of tasks news & lifestyle teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire NewsAPI into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against NewsAPI, with input parameters and output schema. Drop these into any step of an agent built in Helix.
NEWS_API_GET_EVERYTHINGTool to search through every article published by over 150,000 sources. At least one of q, sources, language, or domains must be set or the API returns a parametersMissing error. Historical date range depends on your News API plan tier (free plans limited to ~1 month). No country parameter exists; target geography via sources, domains, or country-specific terms in q. Burst requests may trigger HTTP 429; apply backoff on throttling errors.
Input parameters
Keywords or phrases to search for in the article title and body
Newest date or date-time for articles (YYYY-MM-DD or YYYY-MM-DDThh:mm:ss). Date range limits depend on your News API plan tier (free plans are limited to approximately 1 month of historical data)
Oldest date or date-time for articles (YYYY-MM-DD or YYYY-MM-DDThh:mm:ss). Date range limits depend on your News API plan tier (free plans are limited to approximately 1 month of historical data)
Page number of results to return (default 1) When totalResults exceeds pageSize, increment page to retrieve additional results.
Order to sort articles: relevancy, popularity, or publishedAt
Comma-separated list of domains to include in results
Comma-separated list of source identifiers to filter on Use valid source IDs from NEWS_API_GET_SOURCES; unrecognized IDs silently return empty results.
2-letter ISO-639-1 code to restrict the search to that language
Number of results per page (default 20, max 100)
Keywords or phrases to search for in the article title only
Comma-separated list of domains to exclude from results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEWS_API_GET_SOURCESTool to fetch available news sources. Use when you need to retrieve a list of publishers by optional filters like category, language, or country. Source IDs returned here are the only valid IDs for filtering in NEWS_API_GET_EVERYTHING or NEWS_API_GET_TOP_HEADLINES — unrecognized IDs cause silently empty results.
Input parameters
Filter sources by this country code.
Filter sources by this news category.
Filter sources by this language code.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEWS_API_GET_TOP_HEADLINESTool to retrieve live top and breaking headlines; does not support historical or date-bounded queries (use NEWS_API_GET_EVERYTHING for past date ranges). Results favor major outlets; use NEWS_API_GET_EVERYTHING or COMPOSIO_SEARCH_WEB for niche publications. Use when you need current headlines filtered by country, category, source(s), or keywords.
Input parameters
Keywords or phrase to search for in the article title and body. At least one of 'country', 'category', 'sources', or 'q' must be provided.
Page number for pagination. Default is 1.
2-letter ISO 3166-1 code of the country to get headlines for. At least one of 'country', 'category', 'sources', or 'q' must be provided. Cannot be used with 'sources'.
Comma-separated list of source identifiers to include (max 20). At least one of 'country', 'category', 'sources', or 'q' must be provided. Cannot be combined with 'country' or 'category'. Use valid source IDs from NEWS_API_GET_SOURCES; unrecognized IDs may silently return empty results.
News category to filter by. At least one of 'country', 'category', 'sources', or 'q' must be provided. Cannot be used with 'sources'.
Number of results per page. Default is 20, max is 100.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEWS_API_GET_V1_ARTICLESTool to fetch live article metadata from a news source using the legacy v1 API. Use when you need headlines from a specific source identifier. This v1 endpoint has been superseded by /v2/top-headlines.
Input parameters
Sort order for articles.
The identifier for the news source or blog you want headlines from. Use the /sources endpoint to locate this.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 98 agents privately built on Nagent that already use NewsAPI.
Build on Nagent
Connect NewsAPI to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find NewsAPI, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, NewsAPI is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once NewsAPI is connected, you configure its 4 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop NewsAPI steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a NewsAPI event fires, the agent kicks off automatically.
Every NewsAPI action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While NewsAPI ships with 4 pre-built news & lifestyle actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching NewsAPI together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build NewsAPI-based workflows tailored to your business.