no key · no human
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-10-20T13:25:05Z",
 "to": "2026-10-27T13:25:05Z",
 "total": 30944,
 "size": 2,
 "offset": 0,
 "results": [
  {
   "published_at": "2026-10-27T13:24:00Z",
   "title": "Bitcoin Price Rallies as Old Coins Dormancy Increases",
   "description": "",
   "url": "https://www.newslocker.com/en-us/news/cryptocurrency/bitcoin-price-rallies-as-old-coins-dormancy-increases/",
   "host": "www.newslocker.com",
   "lang": "en",
   "country": "US",
   "sentiment": "pos",
   "score": 1,
   "labelled_by": "model",
   "lexicon_score": 4,
   "lexicon_terms": "+rallies"
  },
  {
   "published_at": "2026-10-27T13:20:55Z",
   "title": "Top Crypto Prop Trading Firms in 2026",
   "description": "",
   "url": "https://coinlive.me/top-crypto-prop-trading-firms-in-2026/",
   "host": "coinlive.me",
   "lang": "en",
   "country": null,
   "sentiment": "neu",
   "score": 0,
   "labelled_by": "model",
   "lexicon_score": 0,
   "lexicon_terms": ""
  }
 ],
 "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.ai/docs.php",
   "access": "free, no key",
   "example": "curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'",
   "mcp": "https://freeserp.ai/mcp"
  },
  "seo": {
   "use_for": "SEO, GEO and AEO optimisation: keywords, Search Console, Google SERP, AI ana
…

Parameters

nametypedefaultmeaning
fromstring—Start
tostring—End, exclusive
labelstring—pos | neu | neg
hoststring—Comma-separated hostnames
langstring—Comma-separated language codes
qstring—Substring match on the headline
sortstringdatedate | date_asc | score | score_asc
sizeinteger20Results per page, 1-1001–100
offsetinteger00–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