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

# Comunicados de prensa

> Esta API REST devuelve datos estructurados de comunicados de prensa. Para un rendimiento óptimo, limite el alcance de la consulta mediante parámetros como símbolos bursátiles, fecha y canales, o use updatedSince para obtener deltas. Los desplazamientos de página están limitados de 0 a 100000.

<ResponseExample>
  ```json Respuesta (200 OK) theme={null}
  [
    {
      "id": 36444586,
      "author": "GlobeNewswire",
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "title": "La empresa XYZ anuncia los resultados de ganancias del 4T de 2023 y sus iniciativas estratégicas",
      "teaser": "",
      "body": "",
      "url": "https://www.benzinga.com/pressreleases/24/01/g36444586/company-xyz-announces-q4-2023-earnings-results-and-strategic-initiatives",
      "image": [
        {
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/press_release_image.jpeg"
        },
        {
          "size": "small",
          "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/press_release_image.jpeg"
        },
        {
          "size": "large",
          "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/press_release_image.jpeg"
        }
      ],
      "channels": [
        {
          "name": "Comunicados de prensa"
        }
      ],
      "stocks": [
        {
          "name": "AAPL",
          "cusip": "037833100",
          "isin": "US0378331005",
          "exchange": "NASDAQ"
        }
      ],
      "tags": [
        {
          "name": "Comunicado de prensa"
        }
      ]
    }
  ]
  ```

  ```json Respuesta (401 No autorizado) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "Token de autenticación no válido o ausente"
      }
    ]
  }
  ```

  ```json Respuesta (404 No encontrado) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "No se encontraron datos para los parámetros especificados"
      }
    ]
  }
  ```

  ```json Respuesta (500 Error interno del servidor) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "Se produjo un error inesperado al procesar su solicitud"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml es/openapi/press-releases_api.spec.yml GET /api/v2/news
openapi: 3.0.0
info:
  contact: {}
  description: Autenticación mediante token Bearer
  title: Press Releases v2
  version: 2.0.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v2/news:
    get:
      tags:
        - Press Releases
      summary: Comunicados de prensa
      description: >-
        Esta API REST devuelve datos estructurados de comunicados de prensa.
        Para un rendimiento óptimo, limite el alcance de la consulta mediante
        parámetros como símbolos bursátiles, fecha y canales, o use updatedSince
        para obtener deltas. Los desplazamientos de página están limitados de 0
        a 100000.
      operationId: get-press-releases
      parameters:
        - description: Especifique el formato de salida
          in: header
          name: accept
          required: true
          schema:
            type: string
            enum:
              - application/json
              - application/xml
            default: application/json
        - description: >-
            Desplazamiento de página. Por motivos de optimización, rendimiento y
            razones técnicas, los desplazamientos de página están limitados de 0
            a 100000. Limite los resultados de la consulta con otros parámetros,
            como la fecha.
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: 'Número de resultados devueltos. Máximo: 100.'
          in: query
          name: pageSize
          schema:
            type: integer
            maximum: 100
            default: 15
        - description: >-
            Especifique si desea solo el titular (headline), titular + resumen
            (abstract) o titular + cuerpo completo (full)
          in: query
          name: displayOutput
          schema:
            type: string
            enum:
              - full
              - abstract
              - headline
            default: headline
        - description: >-
            La fecha para consultar noticias. Forma abreviada de dateFrom y
            dateTo si son iguales. Formato: yyyy-mm-dd
          in: query
          name: date
          schema:
            type: string
        - description: >-
            Fecha desde la que se realiza la consulta. Ordenado por fecha de
            publicación. Formato: yyyy-mm-dd
          in: query
          name: dateFrom
          schema:
            type: string
        - description: >-
            Fecha hasta la que se realiza la consulta. Ordenado por fecha de
            publicación. Formato: yyyy-mm-dd
          in: query
          name: dateTo
          schema:
            type: string
        - description: >-
            La última marca de tiempo Unix (UTC) de actualización a partir de la
            cual obtener y ordenar los resultados
          in: query
          name: updatedSince
          schema:
            type: integer
        - description: >-
            La última marca de tiempo Unix (UTC) de publicación a partir de la
            cual obtener y ordenar los resultados
          in: query
          name: publishedSince
          schema:
            type: integer
        - description: >-
            Permite controlar la ordenación de los resultados. El valor
            predeterminado es created, DESC. Formato: campo:dirección. Campos de
            ordenación: id, created, updated. Orden de clasificación: asc
            (ascendente), desc (descendente)
          in: query
          name: sort
          schema:
            type: string
            enum:
              - id:asc
              - id:desc
              - created:asc
              - created:desc
              - updated:asc
              - updated:desc
        - description: 'Uno o más ISIN separados por comas. Máximo: 50. Formato: csv'
          in: query
          name: isin
          schema:
            type: string
        - description: >-
            Uno o más CUSIP separados por comas. Máximo: 50. Se requiere un
            acuerdo de licencia. Formato: csv
          in: query
          name: cusips
          schema:
            type: string
        - description: >-
            Uno o más símbolos bursátiles separados por comas. Máximo: 50.
            Formato: csv
          in: query
          name: tickers
          schema:
            type: string
        - description: >-
            Uno o más símbolos bursátiles primarios separados por comas. Filtra
            solo por la asociación con el ticker primario. Formato: csv
          in: query
          name: primaryTickers
          schema:
            type: string
        - description: 'Uno o más nombres o ID de canales separados por comas. Formato: csv'
          in: query
          name: channels
          schema:
            type: string
        - description: >-
            Una o más palabras o frases separadas por comas; busca en Título,
            Etiquetas y Cuerpo en ese orden de prioridad. Formato: csv
          in: query
          name: topics
          schema:
            type: string
        - description: >-
            Operador lógico para la consulta de temas. Use 'and' para exigir
            todos los temas y 'or' para exigir cualquiera de los temas
          in: query
          name: topic_group_by
          schema:
            type: string
            enum:
              - and
              - or
            default: or
        - description: 'Uno o más autores separados por comas. Formato: csv'
          in: query
          name: authors
          schema:
            type: string
        - description: Especifique el formato deseado para la respuesta de la API
          in: query
          name: format
          schema:
            type: string
            enum:
              - text
        - description: Filtrar por nivel de importancia
          in: query
          name: importance
          schema:
            type: string
            enum:
              - low
              - medium
              - high
        - description: >-
            Filtrar por región (p. ej., 'ca' o 'canada' para contenido
            canadiense)
          in: query
          name: region
          schema:
            type: string
      responses:
        '200':
          description: éxito
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/api.NewsItem'
                type: array
            text/xml:
              schema:
                items:
                  $ref: '#/components/schemas/api.NewsItem'
                type: array
        '400':
          description: Parámetros de consulta no válidos o ausentes
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
        '499':
          description: Contexto de la solicitud cancelado
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
        '500':
          description: Error interno
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
      security:
        - ApiKeyAuth: []
components:
  schemas:
    api.NewsItem:
      description: Elemento de artículo de noticias con todos los metadatos
      properties:
        author:
          example: Benzinga Newsdesk
          type: string
        body:
          type: string
        channels:
          items:
            $ref: '#/components/schemas/api.ChannelTag'
          type: array
        created:
          example: Wed, 17 May 2017 14:20:15 -0400
          type: string
        id:
          example: 123456
          type: integer
        image:
          items:
            $ref: '#/components/schemas/api.Image'
          type: array
        original_id:
          type: integer
        stocks:
          items:
            $ref: '#/components/schemas/api.Stock'
          type: array
        tags:
          items:
            $ref: '#/components/schemas/api.ChannelTag'
          type: array
        teaser:
          type: string
        title:
          example: Apple Announces New iPhone
          type: string
        updated:
          example: Wed, 17 May 2017 14:20:15 -0400
          type: string
        url:
          example: https://www.benzinga.com/news/123456
          type: string
      type: object
    api.ChannelTag:
      description: Nombre del canal o de la etiqueta
      properties:
        name:
          example: Technology
          type: string
      type: object
    api.Image:
      description: Imagen del artículo con tamaño y URL
      properties:
        size:
          example: large
          type: string
        url:
          example: https://cdn.benzinga.com/files/images/story/2024/example.jpg
          type: string
      type: object
    api.Stock:
      description: Información bursátil con símbolo bursátil e identificadores
      properties:
        cusip:
          example: '037833100'
          type: string
        exchange:
          example: NASDAQ
          type: string
        isin:
          example: US0378331005
          type: string
        name:
          example: AAPL
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Autenticación con clave API. Proporcione su clave API como parámetro de
        consulta.
      in: query
      name: token
      type: apiKey

````