ASasksurf
Search

News Article Search

Changed on

Searches crypto news articles by keyword.

Returns results ranked by relevance (default) or newest first (sort_by=recency), with highlighted matching fragments. Optional from / to bound the publish time; a poller watching a keyword should pass sort_by=recency and from=<last seen published_at>. Supports pagination via limit and offset.

get/gateway/v1/search/news

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

qstring required

Search keyword or phrase

Example:bitcoin ETF
fromstring

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

Example:2024-01-01
tostring

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

Example:2024-02-01
sort_by'relevance' | 'recency'

Sort order: relevance (best match first) or recency (newest first). Pollers watching a keyword should use recency with from set to their last seen published_at

Example:relevance
limitinteger

Results per page

Example:10
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseNewsArticleItem.json"
}

Changes

  • 3f0042c062eeRevision changes
    • info

      added the new optional query request parameter from

    • info

      added the new optional query request parameter sort_by

    • info

      added the new optional query request parameter to