canonical: https://jentic.com/apis/freenewsapi.io/freenewsapi # Free News API The Free News API serves news articles and their full details, and searches publishers and authors across sources. It lists the languages available for a country and the available topics, so queries can be filtered by language and subject. Requests are authenticated with an API key sent in a request header. ## For AI agents Search and list news articles, fetch the full details of an article, and look up publishers and authors. Discover the languages available by country and the available topics to filter queries. ## Scope Does not publish articles, send newsletters, or run sentiment analysis. Use for searching news articles, publishers, authors, languages, and topics only. ## Capabilities - List and search news articles across sources - Fetch the full details of a single article - Search publishers by name or attributes - Search authors across articles - List the languages available for a given country - List the available topics for filtering news ## Use cases ### Agent News Retrieval An AI agent connected through Jentic can search for news articles on a topic, fetch the full details of the most relevant one, and identify the publisher behind it, without a developer wiring the Free News API by hand. The agent discovers each operation by intent and calls it with a stored key. Example prompt: Search for articles about a topic, fetch the top article's details, and report its publisher ### Topic and Source Discovery Apps let users browse news by subject and source. The Free News API lists the available topics and searches publishers and authors, so a reader can filter articles by topic and follow specific sources. Example prompt: List the available topics and search publishers that cover a chosen topic ### Localized News Feeds International apps serve news in the right language for each market. The Free News API lists the languages available for a country, so a feed can request articles in a language that fits the audience. Example prompt: List the languages available for a country and search news articles in the chosen language ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/news` | List news articles | | GET | `/details` | Get article details | | GET | `/publishers` | Search publishers | | GET | `/authors` | Search authors | | GET | `/languages` | List available languages for a country | | GET | `/topics` | List available topics | ## Key resources - **Articles** — List and search news articles and fetch a single article's details - **Publishers** — Search publishers across sources - **Authors** — Search authors across articles - **Languages** — List the languages available for a country - **Topics** — List the available topics for filtering news ## AI readiness 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. - **Score:** 51 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 66 / 100 - AI-Readiness & Agent Experience: 26 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 75 / 100 - **View full report:** https://jentic.com/apis/freenewsapi.io/freenewsapi/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Free News API by hand means managing its API key header, learning each query's parameters, and paging through results yourself. Through Jentic you install once, import the Free News API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Free News API is read-only with six operations, so a rule can allow only the article and lookup reads your agent needs. You choose the operations the agent may call, and because none of them write, the agent can search news but change nothing. - **Credential handling:** Your Free News API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'search news articles' or 'get article details', and Jentic returns the matching Free News API operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **NewsAPI** — News search API across thousands of sources with article metadata. - **GNews** — News search and headlines API with language and country filters. - **Mediastack** — Live and historical news data feed by keyword, source, and category. - **New York Times Article Search** — Searches New York Times articles as a specific premium source. ## FAQ ### What authentication does the Free News API use? The Free News API authenticates with an API key sent in the `x-api-key` request header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's context. ### Can I fetch the full details of an article with the Free News API? Yes. After listing or searching articles, the details operation returns the full content and metadata for a single article so an agent can read or summarize it. ### Can I limit what my agent is allowed to do with the Free News API? Yes. The Free News API is read-only, so write a rule that allows only the article-search and detail operations, letting the agent pull news without touching anything else. Every call it makes is logged. ### Is there a Free News API MCP server? You do not need an MCP server to give your agent the Free News API. Jentic connects it directly from the API Directory: import the Free News API, store your key once, and the agent calls its read operations by intent without loading another server's tool definitions into its context. ### What are the rate limits for the Free News API? The OpenAPI spec does not specify numeric rate limits for the Free News API. Check the Free News API documentation at https://freenewsapi.io for current plan limits. ### How do I search news articles with the Free News API through Jentic? Search Jentic for an intent like 'search news articles', and it returns the Free News API's article-search operation with its input schema so your agent can query by topic, language, or source. To run it on your own infrastructure, install Jentic One from its GitHub repo.