Noticias

Esta API REST devuelve datos estructurados de noticias. Para obtener un rendimiento óptimo, limita el alcance de la consulta usando parámetros como tickers, date y channels, o usa updatedSince para obtener solo los cambios. Los desplazamientos de página están limitados al rango de 0 a 100000.

GET /api/v2/news

Obtener las noticias

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'

Respuesta (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

Respuesta (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

Autorizaciones

token · string · query · requerido

Autenticación con clave de API. Proporcione su clave de API como parámetro de consulta.

Encabezados

accept · enum<string> · predeterminado: application/json · requerido

Especifique el formato de respuesta

Opciones disponibles: application/json, application/xml

Parámetros de consulta

page · integer · predeterminado: 0

Desplazamiento de página. Por motivos de optimización, rendimiento y técnicos, los desplazamientos de página están acotados entre 0 y 100000. Limite los resultados de la consulta mediante otros parámetros, como la fecha.

pageSize · integer · predeterminado: 15

Cantidad de resultados devueltos. Máximo 100.

Rango requerido: x <= 100

displayOutput · enum<string> · predeterminado: headline

Especifique si desea solo el titular (headline), titular + entradilla (abstract) o titular + cuerpo completo (full).

Opciones disponibles: full, abstract, headline

date · string

La fecha para consultar las noticias. Equivale de forma abreviada a dateFrom y dateTo si son iguales. Formato: yyyy-mm-dd

dateFrom · string

Fecha a partir de la cual realizar la consulta. Ordenados por fecha de publicación. Formato: yyyy-mm-dd

dateTo · string

Fecha hasta la que se realiza la consulta (punto en el tiempo). Ordenado por fecha de publicación. Formato: yyyy-mm-dd

updatedSince · integer

La última marca de tiempo Unix (UTC) de actualización para extraer y ordenar

publishedSince · integer

Última marca de tiempo Unix (UTC) publicada para obtener y ordenar los datos

sort · enum<string>

Permite controlar la ordenación de los resultados. El valor predeterminado es created, DESC. Formato: campo:orden. Campos de ordenación: id, created, actualizado. Orden de ordenación: asc (ascendente), desc (descendente)

Opciones disponibles: id:asc, id:desc, created:asc, created:desc, updated:asc, updated:desc

isin · string

Uno o más ISIN, separados por comas. Máximo 50. Formato: csv

cusips · string

Uno o más CUSIP separados por comas. Máximo 50. Se requiere un acuerdo de licencia. Formato: CSV

tickers · string

Uno o más símbolos de ticker separados por comas. Máximo 50. Formato: CSV

primaryTickers · string

Uno o más símbolos de ticker principales separados por comas. Filtra solo por asociación con el ticker principal. Formato: CSV

channels · string

Uno o más nombres o ID de canal, separados por comas. Formato: CSV

topics · string

Una o varias palabras o frases separadas por comas; se buscan en el título, las etiquetas y el cuerpo, en ese orden de prioridad. Formato: csv

topic_group_by · enum<string> · predeterminado: or

Operador lógico para la consulta de temas. Utilice 'and' para requerir todos los temas y 'or' para requerir cualquiera de ellos

Opciones disponibles: and, or

authors · string

Uno o más autores separados por una coma. Formato: CSV

content_types · string

Uno o más tipos de contenido separados por una coma. Formato: csv

format · enum<string>

Especifica el formato deseado para la respuesta de la api

Opciones disponibles: text

importance · enum<string>

Filtrar por nivel de importancia

Opciones disponibles: low, medium, high

region · string

Filtra por región (por ejemplo, 'ca' o 'canada' para contenido canadiense)

Respuesta

200

application/json

Correcto

author · string

Ejemplo:

"Benzinga Newsdesk"

body · string

channels · object[]

Mostrar atributos secundarios

created · string

Ejemplo:

"Wed, 17 May 2017 14:20:15 -0400"

id · integer

Ejemplo:

123456

image · object[]

Mostrar atributos secundarios

original_id · integer

stocks · object[]

Mostrar atributos secundarios

tags · object[]

Mostrar atributos secundarios

teaser · string

title · string

Ejemplo:

"Apple Announces New iPhone"

updated · string

Ejemplo:

"Wed, 17 May 2017 14:20:15 -0400"

url · string

Ejemplo:

"https://www.benzinga.com/news/123456"