News Volume API README

pip install news-trends-api
export TRENDSAPI_KEY=your_key

from news_trends_api import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

from news_trends_api import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

series = client.get_time_series("federal reserve")
print(series[-1].date, series[-1].value)

growth = client.get_growth("federal reserve", percent_growth=["3M", "12M"])
print(growth.results[0].growth, growth.results[0].direction)

hot = client.get_live(limit=10)
print(hot.data)                         # [[1, "..."], ...]

points = client.get_time_series("federal reserve")

g = client.get_growth("federal reserve", percent_growth=["12M", "3M", "YTD"])
print(g.results[0].growth, g.results[0].direction)

hot = client.get_live(limit=10)

import asyncio
from news_trends_api import AsyncTrendsAPI

async def main():
    c = AsyncTrendsAPI()
    return await asyncio.gather(
        c.get_time_series("federal reserve"),
        c.get_time_series("federal reserve", source="google search"),
    )

asyncio.run(main())

from dataclasses import asdict
import pandas as pd
from news_trends_api import TrendsAPI

df = pd.DataFrame(asdict(p) for p in TrendsAPI().get_time_series("federal reserve"))
df["date"] = pd.to_datetime(df["date"])
print(df.set_index("date")["value"].resample("ME").mean().tail())

npm install news-trends-api

import { TrendsAPI } from "news-trends-api";

const client = new TrendsAPI({ apiKey: process.env.TRENDSAPI_KEY! });
const series = await client.getTimeSeries("federal reserve");
console.log(series.at(-1)?.date, series.at(-1)?.value);

const growth = await client.getGrowth("federal reserve", {
  percent_growth: ["3M", "12M"],
});
console.log(growth.results[0].growth, growth.results[0].direction);

const live = await client.getLive({ limit: 10 });
console.log(live.data);                 // [[1, "..."], ...]

curl -sS -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer $TRENDSAPI_KEY" \
  -H "Content-Type: application/json" \
  --max-time 60 \
  -d '{"mode":"get_time_series","source":"news volume","keyword":"federal reserve"}'