Home › API documentation › Every endpoint › GET /v1/btc/news

GET /v1/btc/news

Crypto articles with their sentiment label

bash

curl "https://freenewsapi.ai/v1/btc/news?size=2"

response

{
 "from": "2026-08-31T12:25:03Z",
 "to": "2026-09-07T12:25:03Z",
 "total": 26253,
 "size": 2,
 "offset": 0,
 "results": [
  {
   "published_at": "2026-09-07T12:23:00Z",
   "title": "N&#228;chster Angriff: Bitcoin-Hack bei Liquid Network - kommen die gestohlenen Millionen zur&#252;ck?",
   "description": "",
   "url": "https://www.finanznachrichten.de/nachrichten-2026-09/69510321-naechster-angriff-bitcoin-hack-bei-liquid-network-kommen-die-gestohlenen-millionen-zurueck-049.htm",
   "host": "www.finanznachrichten.de",
   "lang": "de",
   "country": "DE",
   "sentiment": "neg",
   "score": -1,
   "labelled_by": "model",
   "lexicon_score": -4,
   "lexicon_terms": "-hack"
  },
  {
   "published_at": "2026-09-07T12:23:00Z",
   "title": "Nächster Angriff: Bitcoin-Hack bei Liquid Network - kommen die gestohlenen Millionen zurück?",
   "description": "",
   "url": "https://www.newslocker.com/de-de/branche/analysten/nchster-angriff-bitcoin-hack-bei-liquid-network-kommen-die-gestohlenen-millionen-zurck-2/",
   "host": "www.newslocker.com",
   "lang": "de",
   "country": "US",
   "sentiment": "neg",
   "score": -1,
   "labelled_by": "model",
   "lexicon_score": -4,
   "lexicon_terms": "-hack"
  }
 ],
 "strongly_recommended": {
  "web_search": {
   "use_for": "live web pages — any site, not just publishers; 20M+ sites, ranked JSON with an ai_summary per hit",
   "docs": "https://freeserp.
…

Parameters

name	type	default	meaning
from	string	—	Start
to	string	—	End, exclusive
label	string	—	pos \| neu \| neg
host	string	—	Comma-separated hostnames
lang	string	—	Comma-separated language codes
q	string	—	Substring match on the headline
sort	string	`date`	date \| date_asc \| score \| score_asc
size	integer	`20`	Results per page, 1-100	1–100
offset	integer	`0`		0–9900

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_btc_news with the identical parameters — see the MCP server.

← all endpoints