Skip to main content

Search categories

Find categories by parent, name or ID, with pagination and sorting.

Query​

query SearchCategories($parentCategoryId: [Int!], $page: Int, $offset: Int) {
  categories(filter: {
    parentCategoryId: $parentCategoryId
    hidden: N
    sortField: name
    sortOrder: ASC
    page: $page
    offset: $offset
  }) {
    itemsFound
    page
    pages
    items {
      categoryId
      name { language value }
      slug { language value }
      hidden
    }
  }
}

Variables​

{
  "parentCategoryId": [17],
  "page": 1,
  "offset": 50
}

Response​

{
  "data": {
    "categories": {
      "itemsFound": 11,
      "page": 1,
      "pages": 1,
      "items": [
        { "categoryId": 1854, "name": [{ "language": "NL", "value": "Audio en video" }], "slug": [{ "language": "NL", "value": "audio-en-video" }], "hidden": "N" },
        { "categoryId": 1922, "name": [{ "language": "NL", "value": "Gereedschap" }], "slug": [{ "language": "NL", "value": "gereedschap" }], "hidden": "N" },
        { "categoryId": 1794, "name": [{ "language": "NL", "value": "ICT and hardware" }], "slug": [{ "language": "NL", "value": "ict-and-hardware" }], "hidden": "N" }
      ]
    }
  }
}

How it works​

The name filter is an exact match and case-sensitive. Array filters like categoryId and parentCategoryId use OR logic (match any). Different filter fields combine with AND logic. Available sort fields: name, dateCreated, dateChanged.

See also​