01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
NewsAPI
4 tools available
News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.
Connect NewsAPI to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call NewsAPI's 4 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with NewsAPI
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
NewsAPI actions 4
Every NewsAPI action below is a callable tool any Definable persona can invoke.
Get Everything
Tool 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.
Get Sources
Tool 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.
Get Top Headlines
Tool 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.
Get V1 Articles
Tool 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.
Benzinga
Benzinga provides real-time financial news and data APIs, offering comprehensive coverage of market-moving information for developers and financial professionals.
Currents API
Currents News API provides access to the latest news articles from various sources worldwide, supporting multiple languages and categories.
Ecologi
Ecologi is the platform for collective climate action. Purchase trees and carbon offsets programmatically through their Impact API.
Hacker News
Hacker News is a tech-focused news aggregator by Y Combinator, featuring user-submitted stories and discussions on startups, programming, and emerging trends
More Trees
More Trees is a sustainability-focused platform planting trees on behalf of individuals or businesses aiming to offset carbon footprints and support reforestation
Perigon
Perigon provides an HTTP REST API for retrieving news and web content data, offering structured data suitable for various applications.
Frequently asked questions
What can I automate with NewsAPI on Definable?
Anything NewsAPI exposes through its API. Common news & lifestyle workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 4 NewsAPI tools directly, then chain the result into another integration without you writing code.
How does NewsAPI authentication work?
NewsAPI uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the NewsAPI integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 4 NewsAPI tools. You only need a separate NewsAPI subscription if NewsAPI itself charges per seat or per API call.
Is using NewsAPI through Definable secure?
Every call from a persona to NewsAPI is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with NewsAPI on Definable?
Sign up for Definable, open the integrations page, find NewsAPI, and connect via OAuth or API key. You can immediately attach NewsAPI to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What NewsAPI actions does Definable expose?
Definable exposes all 4 NewsAPI actions as callable tools — including `Get Everything`, `Get Sources`, `Get Top Headlines`, plus 1 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with NewsAPI?
Wire it up in minutes. No coding required.