GET /v1/feed.json
The same search as JSON Feed 1.1
curl "https://freenewsapi.ai/v1/feed.json?q=energy&size=2"{
"version": "https://jsonfeed.org/version/1.1",
"title": "Free News API — “energy”",
"home_page_url": "http://127.0.0.1:8099",
"feed_url": "http://127.0.0.1:8099/v1/feed.json?q=energy&size=2",
"description": "Live news from freenewsapi.ai — no key required.",
"items": [
{
"id": "https://www.smh.com.au/national/queensland/returning-kindness-the-volunteers-who-emotionally-rejuvenate-roma-street-s-police-20260828-p60sfm.html",
"url": "https://www.smh.com.au/national/queensland/returning-kindness-the-volunteers-who-emotionally-rejuvenate-roma-street-s-police-20260828-p60sfm.html",
"title": "Returning kindness: The volunteers who emotionally rejuvenate Roma Street’s police",
"summary": "This week in our Queensland public sector column, Public Circus reveals energy healing at police HQ, a First Nations Health Office review, energy musical chairs, and more.",
"date_published": "2026-09-07T20:08:10Z",
"image": "https://static.ffx.io/images/$zoom_1%2C$multiply_0.7554%2C$ratio_1.777778%2C$width_1059%2C$x_261%2C$y_185/t_crop_custom/q_86%2Cf_auto/80f02ea23b152b25a9c0edb620b65f4e30209653",
"authors": [
{
"name": "Matt Dennien, Julius Dennis, James Hall"
}
],
"tags": [
"national / queensland"
],
"external_url": "https://www.smh.com.au/national/queensland/returning-kindness-the-volunteers-who-emotionally-rejuvenate-roma-street-s-polic
…Parameters
| name | type | default | meaning | |
|---|---|---|---|---|
| q | string | — | ||
| country | string | — | ||
| lang | string | — | ||
| tld | string | — | ||
| host | string | — | ||
| date | string | — | ||
| from | string | — | ||
| to | string | — | ||
| sort | string | date | ||
| size | integer | 50 | 1–200 | |
| strict_country | boolean | False |
No key, no header, no signup. Unknown query parameters are ignored, so adding one can never break a request. Errors are documented on the errors page.
As an MCP tool
The same endpoint is exposed to agents as news_get_feed_json
with the identical parameters — see the MCP server.