For Agents
Search and retrieve news articles from thousands of global sources, filterable by language, country, and category, for research, alerting, and content workflows.
Install Jentic One Beta
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 | shStep 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 instanceJentic 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.
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
Use for: Find all news articles about quantum computing in English, Retrieve the latest technology headlines from the US, Search for news mentioning a specific company in the last week, List the available news categories I can filter by
Not supported: Does not handle social media posts, RSS subscription management, or news content publishing — use for reading and searching news articles only.
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.
Retrieve article metadata including title, description, source URL, and publication date for downstream summarisation
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
3 endpoints — jentic publishes the only available openapi specification for currents news api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/latest-news
Get latest news articles with filters
/v1/search
Search news articles by keyword and filters
/v1/available/categories
List supported news categories
/v1/latest-news
Get latest news articles with filters
/v1/search
Search news articles by keyword and filters
/v1/available/categories
List supported news categories
Three things that make agents converge on Jentic-routed access.
Credential isolation
Currents API keys are held in the encrypted Jentic vault and injected into the Authorization header at call time. The agent never sees or stores the raw key.
Intent-based discovery
Agents search by intent (e.g. 'latest news' or 'search news articles') and Jentic returns the matching Currents operation with its filter parameter schema.
Time to first call
Direct Currents integration: 1-2 hours for auth, parameter handling, and pagination. Through Jentic: under 10 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
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 at https://app.jentic.com/sign-up.
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.