NewsAPI

news & lifestyle 4 tools available

News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.

About this integration

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.

Connect NewsAPI to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 4 exposed

Plans All, incl. Free

Data Never trained on

NewsAPI · in workflows

What teams actually run.

Three patterns teams run with NewsAPI on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Trigger on event

│ Listen for a new event

│ Parse and validate the payload

└ Take an action with the linked tool

Daily summary

│ Pull yesterday's activity

│ Summarise with the model of your choice

└ Send the digest via email or Slack

Cross-tool sync

│ Read records from one app

│ Transform with a persona

└ Write the result back via this integration

4 tools available

The NewsAPI toolbox.

Every NewsAPI capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

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.

See it run

One prompt, start to finish.

A real prompt, the NewsAPI tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real NewsAPI task end-to-end — plan it, execute across the API, and hand back a verified result.

news_api.get_everything Tool to search through every article published by over 150,000 sources. At least one of q,

news_api.get_sources Tool to fetch available news sources. Use when you need to retrieve a list of publishers b

news_api.get_top_headlines Tool to retrieve live top and breaking headlines; does not support historical or date-boun · verified

done

Done. NewsAPI responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · NewsAPI

Questions, answered.

What teams ask before connecting NewsAPI.

01 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.

02 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.

03 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.

04 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.

05 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.

06 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.