no key · no human
HomeAPI documentationEvery endpointGET /v1/feed.json

GET /v1/feed.json

The same search as JSON Feed 1.1

bash
curl "https://freenewsapi.ai/v1/feed.json?q=energy&size=2"
response
{
 "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

nametypedefaultmeaning
qstring
countrystring
langstring
tldstring
hoststring
datestring
fromstring
tostring
sortstringdate
sizeinteger501–200
strict_countrybooleanFalse

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.

← all endpoints