Skip to main content
GET
List News Items

Authorizations

X-Blockworks-API-Key
string
header
required

API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models on the public access tier need no key.

Query Parameters

documentIDEq
string

Document ID equals.

documentIDIsOneOf
string[]

Document ID is one of (comma-separated).

feedDateEq
string<date-time>

Feed Date equals.

feedDateGt
string<date-time>

Feed Date is greater than.

feedDateGte
string<date-time>

Feed Date is greater than or equal to.

feedDateLt
string<date-time>

Feed Date is less than.

feedDateLte
string<date-time>

Feed Date is less than or equal to.

publishTimeMillisGt
integer<int64>

Publish Time Millis is greater than.

publishTimeMillisGte
integer<int64>

Publish Time Millis is greater than or equal to.

publishTimeMillisLt
integer<int64>

Publish Time Millis is less than.

publishTimeMillisLte
integer<int64>

Publish Time Millis is less than or equal to.

sourceIDEq
string

Source ID equals.

sourceIDIsOneOf
string[]

Source ID is one of (comma-separated).

sourceIDIsNotOneOf
string[]

Source ID is not one of (comma-separated).

sourceNameEq
string

Source Name equals.

sourceNameIsOneOf
string[]

Source Name is one of (comma-separated).

sourceTypeEq
string

Source Type equals.

sourceTypeIsOneOf
string[]

Source Type is one of (comma-separated).

sourceTypeIsNotOneOf
string[]

Source Type is not one of (comma-separated).

isVideoEq
boolean

Is Video equals.

isVideoNotEq
boolean

Is Video does not equal.

Is Recommended equals.

Is Recommended does not equal.

isPriceAnalysisEq
boolean

Is Price Analysis equals.

isPriceAnalysisNotEq
boolean

Is Price Analysis does not equal.

assetIDsIncludes
string

Asset IDs array includes.

assetIDsNotIncludes
string

Asset IDs array does not include.

assetIDsIncludesAnyOf
string[]

Asset IDs array includes any of (comma-separated).

assetIDsNotIncludesAnyOf
string[]

Asset IDs array includes none of (comma-separated).

sortBy
enum<string>
default:feedDate

Field to sort by; defaults to the model's default sort column.

Available options:
feedDate,
publishTimeMillis
sortDirection
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc
page
integer

1-based page number.

pageSize
integer

Rows per page (max 1000, default 100).

selections
enum<string>[]

Comma-separated fields to return; defaults to all fields.

Available options:
documentID,
title,
url,
summary,
feedDate,
publishTimeMillis,
sourceID,
sourceName,
sourceType,
isVideo,
isRecommended,
isPriceAnalysis,
ogImageURL,
assetIDs,
assets
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

One page of matching rows, with the totals for the whole filtered set.

data
object[]
required
metadata
object
required

Pagination totals for the full filtered result set, independent of the current page.

error
string | null