> ## 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 top stories feed

> Returns top stories across categories for the requested locale and their latest generation statuses.



## OpenAPI

````yaml https://api.superwize.ai/api/openapi.json post /news/getTopStories
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/getTopStories:
    post:
      tags:
        - News
      summary: Get top stories feed
      description: >-
        Returns top stories across categories for the requested locale and their
        latest generation statuses.
      operationId: news.getTopStories
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                locale:
                  enum:
                    - en
                    - ur
              required:
                - locale
            example:
              locale: en
      responses:
        '200':
          description: Top stories feed returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  category:
                    const: top-stories
                  locale:
                    enum:
                      - en
                      - ur
                  statuses:
                    type: array
                    items:
                      type: object
                      properties:
                        category:
                          enum:
                            - business
                            - world
                            - tech-science
                            - health
                            - sports
                            - finance
                            - entertainment
                        status:
                          enum:
                            - pending
                            - running
                            - completed
                            - failed
                        isFallback:
                          type: boolean
                      required:
                        - category
                        - status
                        - isFallback
                  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
                  - statuses
                  - articles
              example:
                category: top-stories
                locale: en
                statuses:
                  - category: business
                    status: pending
                    isFallback: true
                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

````