canonical: https://jentic.com/apis/currentsapi.services/currentsapi

# Currentsapi Services Currents News API

Jentic publishes the only available OpenAPI specification for Currents News API, keeping it validated and agent-ready. Currents News API delivers global news articles aggregated from thousands of sources, with filtering by language, country, and category. The compact REST surface covers latest-news retrieval, full-text search across the archive, and a metadata endpoint for available categories. Authentication is by API key in the Authorization header.

## For AI agents

Search and retrieve news articles from thousands of global sources, filterable by language, country, and category, for research, alerting, and content workflows.

## Scope

Does not handle social media posts, RSS subscription management, or news content publishing - use for reading and searching news articles only.

## Capabilities

- Pull the latest news articles filtered by language, country, or category
- Search the news archive by keyword across multiple languages and regions
- List the set of available categories for use in filters and faceted search
- Retrieve article metadata including title, description, source URL, and publication date for downstream summarisation

## Use cases

### Brand and Topic Monitoring

Track mentions of a brand, product, or topic across global news sources by polling the /v1/search endpoint with keyword and language filters. Suitable for PR teams, competitive intelligence, and market researchers who need a daily or hourly digest of relevant coverage without scraping individual outlets.

Example prompt: Call GET /v1/search with keywords='Acme Corp' and language=en to retrieve all English-language articles mentioning the brand in the most recent window

### Localised News Feed

Power a country- or language-specific news feed inside an app or dashboard by calling /v1/latest-news with the appropriate filters. Currents aggregates from thousands of publishers, so a single call returns a curated mix of headlines with title, summary, and source URL ready for display.

Example prompt: Call GET /v1/latest-news with country=DE and language=de to populate a German-language headline feed for a homepage widget

### Category-Faceted News Search

Build a faceted search UI where users pick from valid categories before querying the news index. Pull the canonical category list from /v1/available/categories on app load, then issue /v1/search calls scoped to the chosen category for relevant results.

Example prompt: Call GET /v1/available/categories to populate a dropdown, then GET /v1/search with category=technology and keywords='AI regulation' when the user submits

### AI Agent News Briefing via Jentic

An AI agent generating a morning briefing uses Jentic to discover and call Currents directly. The agent searches for 'latest news', loads the /v1/latest-news schema, supplies country and category filters, and summarises the returned articles for the user without bespoke integration glue.

Example prompt: Use Jentic to search 'latest news' and execute /v1/latest-news with category=business and language=en to compile a morning briefing

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /v1/latest-news | Get latest news articles with filters |
| GET | /v1/search | Search news articles by keyword and filters |
| GET | /v1/available/categories | List supported news categories |

## Key resources

- **Latest News** — Most recent articles filtered by language, country, or category
- **Search** — Full-text search across the news archive with keyword and filter parameters
- **Categories** — Catalogue of supported category values for filtering

## Why Jentic

- **Setup:** Wiring the Currents News API by hand means placing your API key in the Authorization header, targeting the api.currentsapi.services host, and handling retries around news queries yourself. Through Jentic you install once, import the Currents News API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** This surface is read-only, with search terms and filters passed as query parameters rather than an id in the URL path, so limit the agent to the operations it needs, such as reading latest news or searching articles. You choose which of those read operations are in scope.
- **Credential handling:** Your Currents API key is stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'latest news' or 'search news articles', and Jentic returns the matching Currents operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **NewsAPI** — Larger news aggregator with sources, headlines, and everything endpoints
- **GNews** — Google News-style aggregator with similar search and headline endpoints
- **TheNewsAPI** — News aggregator with similar headlines, search, and metadata endpoints

## FAQ

### Why is there no official OpenAPI spec for Currents News API?

Currents does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Currents News API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Currents News API use?

The API uses an API key passed in the Authorization header on every request. Through Jentic the key is stored in the encrypted vault and injected at execution time so the raw token is never exposed to the agent.

### Can I filter news by country and language with the Currents News API?

Yes. Both /v1/latest-news and /v1/search accept country and language query parameters. Use ISO codes (e.g. country=US, language=en) to scope results.

### What are the rate limits for the Currents News API?

Rate limits are governed by the Currents subscription tier and are not encoded in the spec. Free plans typically permit a few hundred requests per day; paid plans raise the limit.

### How do I search for news mentioning a specific topic through Jentic?

Run pip install jentic, search for 'search news articles', load the /v1/search operation, and execute it with keywords, language, and an optional category filter. Jentic returns the matching articles with title, description, and source URL.

### How do I list the available news categories?

Call GET /v1/available/categories. The response is a JSON list of category strings that you can use as the category filter on /v1/latest-news and /v1/search.

### Can I limit what my agent is allowed to do with the Currents News API?

Yes. Because you run Jentic One yourself, you decide which of the Currents News API's read operations your agent can call, and this surface is read-only. You can allow only latest-news retrieval on /v1/latest-news, or add article search on /v1/search and the category listing on /v1/available/categories, and exclude the rest. Search terms and filters like country, language, and category are passed as query parameters, so your rules govern exactly which reads the agent may perform.