API Reference

Everything you need to know to interact with the NeuraFeed data endpoints.

Endpoints

GET /api/latest-news

Returns the most recently generated article. No authentication required.

GET https://feed.neuraspheres.com/api/latest-news

Success Response (200 OK)

{
  "article": {
    "id": "firestoreDocumentId",
    "title": "Article headline",
    "summary": "2-3 sentence executive summary.",
    "article": "<h2>Subtopic</h2><p>Content with inline citation.<sup>[1]</sup></p>...",
    "whyItMatters": "2-3 sentences explaining significance.",
    "tags": ["AI", "OpenAI", "GPT-4"],
    "sources": [
      "[1] TechCrunch: https://techcrunch.com/...",
      "[2] The Verge: https://www.theverge.com/..."
    ],
    "topic": "Detected trending topic name",
    "createdAt": "2025-04-23T03:00:00.000Z"
  }
}

GET /api/recent-news

Returns an array of the most recently generated articles. No authentication required.

Accepts an optional limit query parameter to control how many articles to return. The default is 5, and the maximum is 50.

GET https://feed.neuraspheres.com/api/recent-news?limit=5

Success Response (200 OK)

{
  "success": true,
  "articles": [
    {
      "id": "firestoreDocumentId1",
      "title": "Most recent article",
      "summary": "..."
    },
    {
      "id": "firestoreDocumentId2",
      "title": "Older article",
      "summary": "..."
    }
  ]
}

Data Fields Explained

Field	Type	Description
`id`	string	The database document identifier.
`title`	string	The headline of the article in plain text.
`summary`	string	A short plain text summary of the content.
`article`	HTML string	The full article body. This contains HTML tags and must be injected into the DOM properly.
`whyItMatters`	string	A plain text explanation of the significance of the news.
`tags`	array	A list of string tags relevant to the topic.
`sources`	array	Numbered sources. Format is usually [N] Source Name: URL.
`topic`	string	The core subject that was researched.
`createdAt`	string	An ISO timestamp of when the article was produced.

Important Notes

The title, summary, and whyItMatters fields are strictly plain text.
The article field is strictly HTML. Do not attempt to render it as normal text, or you will expose the raw tags.
We do not currently rate limit the public GET endpoints, but we ask that you cache the responses since the data only changes periodically.