Skip to main content
GET
/
gateway
/
v1
/
news
/
feed
Crypto News Feed
curl --request GET \
  --url https://api.ask.surf/gateway/v1/news/feed
{
  "data": [
    {
      "id": "<string>",
      "published_at": 123,
      "title": "<string>",
      "highlights": {},
      "project_id": "<string>",
      "project_name": "<string>",
      "source": "<string>",
      "summary": "<string>",
      "url": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

source
enum<string>

Filter by news source

Available options:
coindesk,
cointelegraph,
theblock,
decrypt,
dlnews,
blockbeats,
bitcoincom,
coinpedia,
ambcrypto,
cryptodaily,
cryptopotato,
phemex,
panews,
odaily,
tradingview,
chaincatcher,
techflow
Example:

"coindesk"

project
string

Comma-separated project names to filter by

Example:

"bitcoin,ethereum"

from
string

Filter articles published on or after this time. Accepts Unix seconds or date string (2024-01-01)

Example:

"2024-01-01"

to
string

Filter articles published on or before this time. Accepts Unix seconds or date string (2024-02-01)

Example:

"2024-02-01"

sort_by
enum<string>
default:recency

Sort order: recency (newest first) or trending (hot right now)

Available options:
recency,
trending
Example:

"recency"

limit
integer<int64>
default:20

Results per page (max 50)

Required range: 1 <= x <= 50
Example:

20

offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseNewsArticleItem.json"