GET /api/articles

Public access · HTTP API reference

All endpoints · Authentication and retries · Download OpenAPI

Request

Parameter	Location	Type and requirement
`limit`	query	string · optional
`beforePublishedAt`	query	string · optional
`beforeId`	query	string · optional
`symbol`	query	string · optional
`slug`	query	string · optional
`includePremiumPreview`	query	string · optional
`includePresentation`	query	string · optional

No request body.

Example

Examples use fictional data. Replace identifiers with resources you can access. For account requests, cookies.txt must contain your own session; set CSRF_TOKEN to the matching CSRF cookie value where required.

cURL (POSIX shell)

curl --include \
  --request GET \
  'https://api.weavers.app/api/articles'

Responses

200 · Successful response.

application/json

200 example · synthetic data

{
  "articles": [],
  "nextCursor": null
}

View response model

articles required · array of object

View articles model

Array items:

isUnlocked required · boolean

unlockCost required · null | number

View unlockCost model

Variant 1: null

null

Variant 2: number

number

lockedReason required · null | "auth_required" | "entitlement_required"

View lockedReason model

Variant 1: null

null

Variant 2: "auth_required"

"auth_required"

Variant 3: "entitlement_required"

"entitlement_required"

likes required · number

liked required · boolean

saved required · boolean

id required · string

kind required · "signal" | "report"

articleType required · "upward_channel" | "downward_channel" | "generic"

symbol required · string

instrumentName required · null | string

View instrumentName model

Variant 1: null

null

Variant 2: string

string

assetType required · null | "ETF" | "Stock"

View assetType model

Variant 1: null

null

Variant 2: "ETF"

"ETF"

Variant 3: "Stock"

"Stock"

timeframe required · string

title required · string

summary required · string

url required · string

sourceName required · string

publishedAt required · string

readingTime required · string

coverImage required · string

tags required · array of string

View tags model

Array items:

string

reactions required · number

comments required · number

accessTier required · "free" | "premium"

presentation optional · object

View presentation model

symbol required · string

timeframe required · string

direction required · "upward" | "downward"

publishedAt required · string

windowSize required · number

summary required · string

candles required · array of object

View candles model

Array items:

time required · string

open required · number

high required · number

low required · number

close required · number

Additional fields: JSON values.

strategy required · null | object

View strategy model

Variant 1: null

null

Variant 2: object

strategyRegistryId required · null | number

View strategyRegistryId model

Variant 1: null

null

Variant 2: number

number

strategyKey required · string

strategyVariant required · string

strategyId required · null | string

View strategyId model

Variant 1: null

null

Variant 2: string

string

alias required · null | string

View alias model

Variant 1: null

null

Variant 2: string

string

displayName required · null | string

View displayName model

Variant 1: null

null

Variant 2: string

string

Additional fields: JSON values.

nextCursor required · null | object

View nextCursor model

Variant 1: null

null

Variant 2: object

publishedAt required · string

id required · string

Additional fields: JSON values.

304 · Cached representation is still current; no body.

No JSON response body. Check the status and headers.

400 · Invalid request.

application/json

400 example · synthetic data

{
  "error": "example"
}

View response model

error required · string

Additional fields: JSON values.

429 · Rate limit reached; honor Retry-After when supplied.

application/json

429 example · synthetic data

{}

View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string

code optional · string

message optional · string

Additional fields: JSON values.

500 · Server failure.

application/json

500 example · synthetic data

{
  "error": "example"
}

View response model

Variant 1: object

error required · string

Additional fields: JSON values.