articles

Artículos publicados de la tienda, con búsqueda y filtros por carpeta y etiqueta.

articles devuelve los artículos publicados de la tienda, del más reciente al más antiguo. Cada elemento es un resumen; el artículo completo se pide por slug en REST.

articles(search: String, folder: String, tag: String, limit: Int): [CmsArticlePublicSummaryDto!]!

Argumentos

Los filtros se combinan: un artículo debe cumplir todos los que envíes.

Argumento	Tipo	Predeterminado	Regla
`search`	`String`	—	Busca en título y extracto, sin distinguir mayúsculas.
`folder`	`String`	—	Carpeta exacta.
`tag`	`String`	—	Etiqueta exacta.
`limit`	`Int`	`24`	Hasta 100. Más de 100 usa 100; menos de 1 usa 24.

CmsArticlePublicSummaryDto

Campo	Tipo	Descripción
`id`	`String!`	ID del artículo.
`title`	`String!`	Título.
`slug`	`String!`	Slug.
`author`	`String!`	Autor.
`folder`	`String`	Carpeta.
`tags`	`[String!]!`	Etiquetas.
`coverUrl`	`String`	URL de la portada.
`excerpt`	`String`	Extracto.
`publishedOn`	`DateTime!`	Fecha de publicación.

Ejemplo

Articles.graphql

query Articles($folder: String, $limit: Int) {
  articles(folder: $folder, limit: $limit) {
    id
    title
    slug
    author
    tags
    coverUrl
    excerpt
    publishedOn
  }
}

Terminal

curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Articles($folder: String, $limit: Int) { articles(folder: $folder, limit: $limit) { id title slug author tags coverUrl excerpt publishedOn } }",
    "variables": { "folder": "Guías", "limit": 6 }
  }'

Respuesta

{
  "data": {
    "articles": [
      {
        "id": "7204558912004326001",
        "title": "Cómo elegir una taza",
        "slug": "como-elegir-una-taza",
        "author": "Ana",
        "tags": ["cerámica"],
        "coverUrl": null,
        "excerpt": "Materiales, tamaños y cuidados.",
        "publishedOn": "2026-10-20T14:00:00Z"
      }
    ]
  }
}

Errores

Código	Causa
`STORE_CONTEXT_REQUIRED`	`x-Store-Domain` falta o no corresponde a una tienda.

Equivalente REST

GET /v1/articles devuelve la misma lista con los mismos filtros. Para el artículo completo, con su cuerpo y sus datos SEO, usa GET /v1/articles/{slug}.