Queries
articles
The store's published articles, with search and folder and tag filters.
articles returns the store's published articles, newest first. Each item is a summary; request the full article by slug in REST.
articles(search: String, folder: String, tag: String, limit: Int): [CmsArticlePublicSummaryDto!]!Arguments
Filters combine: an article must match every one you send.
| Argument | Type | Default | Rule |
|---|---|---|---|
search | String | — | Searches title and excerpt, case-insensitive. |
folder | String | — | Exact folder. |
tag | String | — | Exact tag. |
limit | Int | 24 | Up to 100. Above 100 uses 100; below 1 uses 24. |
CmsArticlePublicSummaryDto
| Field | Type | Description |
|---|---|---|
id | String! | Article ID. |
title | String! | Title. |
slug | String! | Slug. |
author | String! | Author. |
folder | String | Folder. |
tags | [String!]! | Tags. |
coverUrl | String | Cover image URL. |
excerpt | String | Excerpt. |
publishedOn | DateTime! | Publication date. |
Example
query Articles($folder: String, $limit: Int) {
articles(folder: $folder, limit: $limit) {
id
title
slug
author
tags
coverUrl
excerpt
publishedOn
}
}curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: my-store" \
--data-binary '{
"query": "query Articles($folder: String, $limit: Int) { articles(folder: $folder, limit: $limit) { id title slug author tags coverUrl excerpt publishedOn } }",
"variables": { "folder": "Guides", "limit": 6 }
}'{
"data": {
"articles": [
{
"id": "7204558912004326001",
"title": "How to choose a mug",
"slug": "how-to-choose-a-mug",
"author": "Ana",
"tags": ["ceramics"],
"coverUrl": null,
"excerpt": "Materials, sizes and care.",
"publishedOn": "2026-10-20T14:00:00Z"
}
]
}
}Errors
| Code | Cause |
|---|---|
STORE_CONTEXT_REQUIRED | x-Store-Domain is missing or doesn't match a store. |
REST equivalent
GET / returns the same list with the same filters. For the full article, with its body and SEO data, use GET /.
Last updated: