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

# List news sources

> List the active news outlets whose exact names are valid values for the sources and exclude_sources filters.



## OpenAPI

````yaml news-api/openapi.json GET /v1/sources
openapi: 3.0.3
info:
  title: Clair News API
  version: 1.0.0
  description: >-
    Keyword-first search over a continuously maintained English-language news
    index. Search titles and cleaned content with familiar web syntax, or omit
    the query to walk canonical articles newest first. Public requests read
    Clair's prebuilt index only; they never crawl a caller-supplied URL or
    invoke an embedding model.
servers:
  - url: https://clair-news-api.p.rapidapi.com
    description: RapidAPI gateway. Use the exact host shown on the Clair News API listing.
security:
  - rapidApiKey: []
paths:
  /v1/sources:
    get:
      summary: List active news sources
      description: >-
        Returns active source names alphabetically. Every item is an exact valid
        value for the `sources` and `exclude_sources` filters on `GET /v1/news`.
        The endpoint deliberately does not expose per-source counts, date
        ranges, feed URLs, or internal source IDs.
      operationId: listNewsSources
      responses:
        '200':
          description: The active source names.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SourceListResponse'
        '401':
          description: Missing or invalid RapidAPI authorization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: RapidAPI plan rate limit exceeded.
        '500':
          description: Unexpected internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: >-
            The platform or News product is unavailable, or the endpoint is at
            capacity. Honor `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '504':
          description: The request exceeded its processing deadline.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  schemas:
    SourceListResponse:
      type: object
      additionalProperties: false
      required:
        - count
        - items
      properties:
        count:
          type: integer
          minimum: 0
        items:
          type: array
          description: Active source names in alphabetical order.
          items:
            type: string
          example:
            - Al Jazeera English
            - Deutsche Welle (English)
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Stable machine-readable code.
        detail:
          description: >-
            Human-readable detail. Validation errors use an array; typed errors
            use a string.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
      example:
        error: bad_cursor
        detail: cursor is invalid or belongs to a different search
  securitySchemes:
    rapidApiKey:
      type: apiKey
      in: header
      name: X-RapidAPI-Key
      description: >-
        Your RapidAPI subscription key. Also send `X-RapidAPI-Host:
        clair-news-api.p.rapidapi.com`.

````