Currentsapi Services Currents News API

Name: Currents News API
Brand: Currents News API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData TransformationapiKey3 EndpointsREST

For Agents

Install Jentic One Beta

Connect the Currents News API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Currents News API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Currents News API.

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

GET STARTED

Start building with Currents News API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Currents News API for, with concrete tasks.

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

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.

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.

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.

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

Key Endpoints

3 endpoints — jentic publishes the only available openapi specification for currents news api, keeping it validated and agent-ready.

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

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

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.

Intent-based discovery

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.

Time to first call

FAQs

Specific to using Currents News API through Jentic.

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.