Skip to content
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.

ArgumentTypeDefaultRule
searchString—Searches title and excerpt, case-insensitive.
folderString—Exact folder.
tagString—Exact tag.
limitInt24Up to 100. Above 100 uses 100; below 1 uses 24.

CmsArticlePublicSummaryDto

FieldTypeDescription
idString!Article ID.
titleString!Title.
slugString!Slug.
authorString!Author.
folderStringFolder.
tags[String!]!Tags.
coverUrlStringCover image URL.
excerptStringExcerpt.
publishedOnDateTime!Publication date.

Example

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: 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 }
  }'
Response
{
  "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

CodeCause
STORE_CONTEXT_REQUIREDx-Store-Domain is missing or doesn't match a store.

REST equivalent

GET /v1/articles returns the same list with the same filters. For the full article, with its body and SEO data, use GET /v1/articles/{slug}.

Last updated:

On this page