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

# Get category news feed

> Returns curated news for a single category and locale, including run status and fallback metadata.



## OpenAPI

````yaml https://api.superwize.ai/api/openapi.json post /news/getCategoryFeed
openapi: 3.1.1
info:
  title: SuperWize API
  version: 1.1.2
  description: >-
    SuperWize RPC API. Authenticated endpoints support Better Auth session
    cookies, Authorization: Bearer <session_token>, or x-api-key.
servers:
  - url: http://api.superwize.ai/api
security: []
tags:
  - name: System
    description: Service health and internal diagnostics.
  - name: Authentication
    description: Session, email verification, and API token endpoints.
  - name: Audio
    description: Speech-to-text and related audio features.
  - name: Chat
    description: Conversation streaming, history, branching, and feedback.
  - name: Credits
    description: Credit balances, usage history, and reward grants.
  - name: Subscription
    description: Subscription tier and status polling endpoints.
  - name: Mini Apps
    description: Curated mini app catalog endpoints.
  - name: News
    description: Curated news feed, article source, and article feedback endpoints.
  - name: Release Notes
    description: Current app release metadata and features.
  - name: Support
    description: Contact/support request endpoints.
  - name: Images
    description: Image conversion, upload, and retrieval endpoints.
  - name: Files
    description: Generic file upload and retrieval endpoints.
  - name: Notifications
    description: Push token registration and test notifications.
  - name: Group Chat
    description: Group lifecycle, invites, messaging, and realtime events.
  - name: Preferences
    description: User preferences and account-type controls.
  - name: Widgets
    description: Widget thread and interaction endpoints.
  - name: Bookmarks
    description: Bookmark groups and conversation associations.
paths:
  /news/getCategoryFeed:
    post:
      tags:
        - News
      summary: Get category news feed
      description: >-
        Returns curated news for a single category and locale, including run
        status and fallback metadata.
      operationId: news.getCategoryFeed
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  enum:
                    - business
                    - world
                    - tech-science
                    - health
                    - sports
                    - finance
                    - entertainment
                locale:
                  enum:
                    - en
                    - ur
              required:
                - category
                - locale
            example:
              category: business
              locale: en
      responses:
        '200':
          description: Category feed returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  category:
                    enum:
                      - business
                      - world
                      - tech-science
                      - health
                      - sports
                      - finance
                      - entertainment
                  locale:
                    enum:
                      - en
                      - ur
                  run:
                    type: object
                    properties:
                      id:
                        type: string
                      category:
                        enum:
                          - business
                          - world
                          - tech-science
                          - health
                          - sports
                          - finance
                          - entertainment
                      locale:
                        enum:
                          - en
                          - ur
                      bucketStartUtc:
                        type: string
                        format: date-time
                      status:
                        enum:
                          - pending
                          - running
                          - completed
                          - failed
                      targetCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      completedCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      failedCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      errorSummary:
                        anyOf:
                          - type: string
                          - type: 'null'
                      createdAt:
                        type: number
                      updatedAt:
                        type: number
                    required:
                      - id
                      - category
                      - locale
                      - bucketStartUtc
                      - status
                      - targetCount
                      - completedCount
                      - failedCount
                      - errorSummary
                      - createdAt
                      - updatedAt
                  isFallback:
                    type: boolean
                  fallbackRunId:
                    anyOf:
                      - type: string
                      - type: 'null'
                  articles:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        runId:
                          type: string
                        category:
                          enum:
                            - top-stories
                            - business
                            - world
                            - tech-science
                            - health
                            - sports
                            - finance
                            - entertainment
                        locale:
                          enum:
                            - en
                            - ur
                        title:
                          type: string
                        snippet:
                          type: string
                        ranking:
                          type: number
                          minimum: 0
                          maximum: 1
                        contentMarkdown:
                          type: string
                        imageUrl:
                          anyOf:
                            - type: string
                              format: uri
                            - type: 'null'
                        conversationId:
                          type: string
                        responseId:
                          type: string
                        sourceCount:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        previewSourceUrls:
                          type: array
                          items:
                            type: string
                            format: uri
                        createdAt:
                          type: number
                        updatedAt:
                          type: number
                      required:
                        - id
                        - runId
                        - category
                        - locale
                        - title
                        - snippet
                        - ranking
                        - contentMarkdown
                        - imageUrl
                        - conversationId
                        - responseId
                        - sourceCount
                        - previewSourceUrls
                        - createdAt
                        - updatedAt
                required:
                  - category
                  - locale
                  - run
                  - isFallback
                  - fallbackRunId
                  - articles
              example:
                category: business
                locale: en
                run:
                  id: obj_01JHKZ0PV2WX123456789
                  category: business
                  locale: en
                  bucketStartUtc: '2026-01-01T00:00:00.000Z'
                  status: pending
                  targetCount: 3
                  completedCount: 3
                  failedCount: 3
                  errorSummary: A concise summary of the requested content.
                  createdAt: 1767225600000
                  updatedAt: 1767225600000
                isFallback: true
                fallbackRunId: obj_01JHKZ0PV2WX123456789
                articles:
                  - id: obj_01JHKZ0PV2WX123456789
                    runId: obj_01JHKZ0PV2WX123456789
                    category: top-stories
                    locale: en
                    title: Pakistan Tech Outlook
                    snippet: >-
                      Pakistan unveils a nationwide digital classroom initiative
                      to improve student outcomes.
                    ranking: 1
                    contentMarkdown: What are practical AI use-cases for students?
                    imageUrl: https://cdn.superwize.ai/assets/sample.png
                    conversationId: conv_01JHKYW2V8XQ123456789
                    responseId: resp_01JHKYW6J6AB123456789
                    sourceCount: 3
                    previewSourceUrls:
                      - https://cdn.superwize.ai/assets/sample.png
                    createdAt: 1767225600000
                    updatedAt: 1767225600000

````