Currentsapi Services Currents News API
66
AI ReadinessAI-Aware (B)66/100
Agent-ready OpenAPI document · curated by JenticData EnrichmentData TransformationapiKey3 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Search and retrieve news articles from thousands of global sources, filterable by language, country, and category, for research, alerting, and content workflows.
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.
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.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcurrentsapi.services%2Fcurrentsapi" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcurrentsapi.services%2Fcurrentsapi" | 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.
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
Retrieve article metadata including title, description, source URL, and publication date for downstream summarisation
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
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
C
Currents News API
- AI-Aware (B)66/100
100
Foundational Compliance63
Developer Experience & Jentic Compatibility47
AI-Readiness & Agent Experience94
Agent Usability50
Security100
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
100
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
99%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B-Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
47
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: DSignals: 4
37%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
50%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
50
Security
Trust, risk posture, and security compliance.
Grade: C-Signals: 1
50%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
100
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A+Signals: 1
100%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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.
GET STARTED