> ## Documentation Index
> Fetch the complete documentation index at: https://developers.octaviatech.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced Article Search

> Advanced Article Search.



## OpenAPI

````yaml GET /articles/advanceSearch
openapi: 3.1.0
info:
  title: Blog API
  version: 1.0.0
servers:
  - url: https://api.octaviatech.app/cms
    description: Production
security:
  - ApiKeyAuth: []
tags: []
paths:
  /articles/advanceSearch:
    get:
      tags:
        - Articles
      summary: Advanced search articles
      description: >-
        Combine filters (categoryId, subCategoryId, authorId, CSV `tag`,
        optional date range) with pagination & sorting.
      parameters:
        - in: query
          name: categoryId
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
            example: '{{objectId}}'
        - in: query
          name: subCategoryId
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
            example: '{{objectId}}'
        - in: query
          name: authorId
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
            example: '{{objectId}}'
        - in: query
          name: tag
          description: CSV list of tags (single param)
          schema:
            type: string
            example: ai,news
        - in: query
          name: dateFrom
          schema:
            type: string
            format: date
            example: '2025-05-01'
        - in: query
          name: dateTo
          schema:
            type: string
            format: date
            example: '2025-10-31'
        - in: query
          name: page
          schema:
            type: integer
            example: 1
        - in: query
          name: limit
          schema:
            type: integer
            example: 20
        - in: query
          name: sortBy
          schema:
            type: string
            enum:
              - createdAt
              - publishDate
            example: publishDate
        - in: query
          name: sortOrder
          schema:
            type: string
            enum:
              - asc
              - desc
            example: desc
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                success: true
                statusCode: 200
                message: OK
                data:
                  items:
                    - id: '{{objectId}}'
                      tags:
                        - ai
                  pagination:
                    total: 1
                    page: 1
                    limit: 20
                    totalPages: 1
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                success: false
                statusCode: 401
                message: Unauthorized
                data: null
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````