trending

Trending

Trending is a library for retrieving trending information from media platforms. It currently supports the following platforms:

Rust Example

1. Dependency

# Cargo.toml
trending = "0.1.0"

# If you want to use it in a synchronous environment, enable `blocking` feature
trending = { version = "0.1.0", features = ["blocking"] }

2. Create AsyncClient

use std::time::Duration;
use trending::{client::AsyncClient, errors::Result};

// new with default options
let client = AsyncClient::new();

// or new with custom options
let options = ClientOptions::new().with_timeout(Duration::from_secs(5));
let client = AsyncClient::new_with_options(options);

3. Trending Query

// receive 29 trendings from zhihu
let res = client.trending_zhihu().await?;
println!("receive {} trendings from {}", res.result.len(), res.platform);

// 0 -> 货车司机往黄山拉玻璃，因两根松木框架被罚五千元，为何黄山对松木管控这么严格？
// ...
for (index, trending) in res.result.iter().enumerate() {
  println!("{:2} -> {}", index, trending.title);
}

4. Search Query

let req = SearchReq::new("ELON");

let res = client.search_tecent(&req).await?;
// receive 20 trendings from tencent
println!("receive {} searches from {}", res.result.len(), res.platform);

// 0 -> 1万亿美元年薪，Elon Musk创纪录
// ...
for (index, search) in res.result.iter().enumerate() {
  println!("{:2} -> {}", index, search.title);
}

Python Example

1. Dependency

# add dependencies to the project
uv add "trending==0.1.0"

2. Create BlockClient

import * from trending

# new with default options
client = BlockClient()

# or new with custom options
let options = ClientOptions::new().with_timeout(Duration::from_secs(5));
let client = AsyncClient::new_with_options(options);

3. Trending Query

res = client.trending_zhihu()
#receive 29 trendings from zhihu
print("receive", len(res.result), "trendings from", res.platform)

# 0 -> 货车司机往黄山拉玻璃，因两根松木框架被罚五千元，为何黄山对松木管控这么严格？
# ...
for index, trending in enumerate(res.result):
  print(index, "->", trending.title)

4. Search Query

req = SearchReq("ELON")
# SearchReq { keyword: "ELON", page: None, size: None }
print(req)

res = client.search_tecent(req)
#receive 20 trendings from tencent
print("receive", len(res.result), "trendings from", res.platform)

# 0 -> 1万亿美元年薪，Elon Musk创纪录
# ...
for index, search in enumerate(res.result):
  print(index, "->", search.title)