Get blog article collection (storefront callers see published articles only)

GET

/rest/v1/cms/blog/article

Storefront callers — guest (no token) and customer — receive only published articles (blog.is_published = 1): filter[published] is server-forced to 1 for them, so a supplied value is ignored rather than combined. ?sort=categories.active and ?sort=tags.active are denied for them too — both ordered the list by a withheld column over a taxonomy relation, and both of those relations are now themselves scoped (Advisable-com/ecommercen#640 gave Article.categories and Article.tags a visibility scope on blog_categories.is_active / blog_tags.is_active), so the denials are retained as defence-in-depth rather than as the thing that closes the oracle. The blog_date publication window legacy applies to its listings is deliberately NOT reproduced: blog.blog_date is nullable, so a naive window would silently drop every NULL-dated article, and the filter vocabulary has no <= operator to express it without destroying the client's filter[inDates]. Backend callers are unaffected and may filter freely to see drafts.

Parameters

Query Parameters

filter[id]

Filter by article IDs

Type

string

Example"1,2,3"

filter[author]

Filter by author IDs

Type

string

filter[promo]

Filter by promo status

Type

boolean

filter[published]

Filter by published status. Backend callers only — for storefront (guest/customer) callers this value is server-forced to 1 and any supplied value is ignored.

Type

boolean

filter[inDates]

Filter between dates, e.g. 2025-08-25,2025-10-05

Type

string

filter[tagId]

Filter by tag ids

Type

string

filter[title.el]

Filter by title (Greek)

Type

string

filter[slug.el]

Filter by slug (Greek)

Type

string

filter[categorySlug.el]

Filter by slug (Greek)

Type

string

filter[notEmptyContent.el]

Filter articles with non-empty content (Greek)

Type

boolean

Exampletrue

sort

Sort order

Type

string

page

Page number

Type

integer

limit

Pagination limit

Type

integer

with

With relations

Type

string

Responses

Successful operation

Content-Type

application/json

"string"

GET

/rest/v1/cms/blog/article

Playground

Variables

Key

Value

filter[id]

filter[author]

filter[promo]

filter[published]

filter[inDates]

filter[tagId]

filter[title.el]

filter[slug.el]

filter[categorySlug.el]

filter[notEmptyContent.el]

sort

page

limit

with

Samples

Powered by VitePress OpenAPI