3GPP Scout News API

openapi: 3.2.0
info:
  title: 3gppscout Com News API
  version: 0.2.0
  description: 'Operations tagged news across 2 of this provider''s published API definitions: 3gppscout-com-openapi.json, api.json. Each path carries the servers of the definition it was published in.'
tags:
- name: News
paths:
  /news/search:
    get:
      tags:
      - News
      summary: Search News
      description: 'What companies file with regulators, tell investors, and what the news reports, next to their 3GPP work.


        Sources: FCC ECFS filings (metadata: filer, docket, type, date, link, and which key terms ECFS finds in the

        filing), SEC EDGAR 10-K, 10-Q and 8-K filings (summary and short quotes from the filing), GDELT news metadata

        (headline, outlet, date, link), and any press source enabled under Scout''s source policy. Each item has

        source, published date, link, Scout''s own summary, up to two short quotes verified word for word against the

        source, and entities linked to the TDoc catalog (organizations, work items, specs, meetings, releases),

        plus the countries named and any companies outside the catalog.


        Use it for company statements, regulatory filings and market context. It is never evidence of what a 3GPP

        specification says or what a meeting agreed: pair it with the TDoc and spec tools. `coverage` lists the

        sources searched and when each was last refreshed.


        Errors: 400 `invalid_parameter`, 404 `organization_not_found`, 409 `organization_ambiguous` (candidates

        returned), 503 `catalog_timeout`.'
      operationId: search_news
      parameters:
      - name: query
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Words to match in the title, filer or summary, e.g. 'interference'.
          title: Query
        description: Words to match in the title, filer or summary, e.g. 'interference'.
      - name: company
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Comma-separated companies (names, aliases or org_ids), e.g. 'AST SpaceMobile'.
          title: Company
        description: Comma-separated companies (names, aliases or org_ids), e.g. 'AST SpaceMobile'.
      - name: source
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Comma-separated sources: fcc_ecfs, sec_edgar, gdelt, and any enabled press source.'
          title: Source
        description: 'Comma-separated sources: fcc_ecfs, sec_edgar, gdelt, and any enabled press source.'
      - name: topic
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Comma-separated topics: ntn, 6g, ai_ml, ambient_iot, iot, redcap, xr, energy, positioning, isac, slicing, open_ran, spectrum, uav, interference.'
          title: Topic
        description: 'Comma-separated topics: ntn, 6g, ai_ml, ambient_iot, iot, redcap, xr, energy, positioning, isac, slicing, open_ran, spectrum, uav, interference.'
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Published on or after YYYY-MM-DD.
          title: Since
        description: Published on or after YYYY-MM-DD.
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Published on or before YYYY-MM-DD.
          title: Until
        description: Published on or before YYYY-MM-DD.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 15
          minimum: 1
          default: 10
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-refined-from:
- 3gppscout-com-openapi.json
- api.json