# NewsAPI AI integration on Definable

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

## What this connects

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

Vendor: https://newsapi.org/

## Tools available

**4** tools available. First 4:

- `NEWS_API_GET_EVERYTHING` — 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.
- `NEWS_API_GET_SOURCES` — 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.
- `NEWS_API_GET_TOP_HEADLINES` — 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.
- `NEWS_API_GET_V1_ARTICLES` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use NewsAPI

Inside a Definable workflow, NewsAPI is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → NewsAPI** — the Researcher (GPT-5.5) pulls context from NewsAPI (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → NewsAPI** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into NewsAPI (create record, post message, draft email).
- **Designer / Engineer → Distributor → NewsAPI** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via NewsAPI (attach file, open PR comment, post status).

The Verifier checks every NewsAPI call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- news & lifestyle — https://definable.ai/apps/category/news-&-lifestyle/
- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/news_api/
- Same category (news & lifestyle): https://definable.ai/apps/category/news-&-lifestyle/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt