# What's Trending Today – Google Trends, HN, Bluesky & More (`pandabear/trending-topics-aggregator`) Actor

One dataset of what's trending today across Google Trends, Hacker News, Wikipedia, GitHub, Bluesky, Mastodon, Baidu and Toutiao (YouTube, X and Reddit with your own keys). Heat scores, cross-platform clusters, optional AI post ideas. $0.50 per 1,000 trends.

- **URL**: https://apify.com/pandabear/trending-topics-aggregator.md
- **Developed by:** [pdbear](https://apify.com/pandabear) (community)
- **Categories:** Social media, News
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 trend items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What's trending today: Google Trends, HN, Bluesky and more, in one dataset

**Best for:** a scheduled daily brief of what is trending across several public platforms, with a comparable heat score and keyword clusters (the same topic showing up on more than one platform).

**Not for:** a deep Google Trends API replacement (interest-over-time, subregions, related queries on one keyword). Dedicated Google Trends Actors on the Store already do that, with much more usage. This Actor is a multi-source snapshot, not a Trends-only research suite.

Sources that work without extra keys: Google Trends, Hacker News, Wikipedia, GitHub, Bluesky, Mastodon, Baidu, Toutiao. YouTube, X and Reddit run only if you add your own keys. Optional AI post ideas use **your** OpenAI / DeepSeek / xAI / custom key; the key is a secret input and is not written to the dataset or logs. We do not sell model tokens.

#### Why this one

- One run, many public lists, one normalized schema.
- A heat score inside each list (rank 50% + log-scaled native metric 50%; the current README already documents this — keep it, do not invent a new formula).
- Cross-platform clusters: keywords that appear on more than one source (English phrases and Chinese words via jieba).
- Cheap to schedule: **$0.50 per 1,000 trend items**. 6 sources × 10 trends is about **$0.035**, plus $0.005 to start.

#### Quick start

```json
{
  "sources": ["googleTrends", "hackernews", "wikipedia", "github", "bluesky"],
  "maxItemsPerSource": 10,
  "countries": ["US"]
}
```

Optional AI block (your key):

```json
{
  "aiProvider": "deepseek",
  "apiKey": "<your own key>",
  "model": "deepseek-chat",
  "aiTopTopics": 5,
  "creatorNiche": "AI tools",
  "contentPlatform": "YouTube Shorts",
  "contentLanguage": "English"
}
```

#### Pricing (pay per event)

| Event | Price |
|---|---|
| Actor start (per run) | $0.005 |
| Trend item saved | $0.0005 ($0.50 per 1,000) |
| AI content idea | $0.002 (only if you add your own key; your provider bills tokens separately) |

Set a maximum cost per run; the Actor stops cleanly and keeps what it already saved.

#### FAQ

**How is the heat score computed?** Inside each list (platform + country/language), it mixes the rank position (50%) with the log-scaled native metric such as searches, points, views or stars (50%), so the top trend in each list is close to 100.

**What are cross-platform clusters?** Keywords are extracted from titles and trends that share a keyword are grouped. A term trending on Google Trends, Bluesky and Wikipedia at the same time is a stronger signal than a single-list spike.

**Is my AI key safe?** It is a secret input and is not written to the dataset, the logs or the key-value store.

**Can I add other platforms?** Open an issue and name a public, official source.

#### Related actors by pandabear

- [Website Email Extractor & Contact Scraper - Phones & Socials](https://apify.com/pandabear/website-contact-enrichment)
- [App Store Scraper - Search, Top Charts & ASO Keyword Ranks](https://apify.com/pandabear/app-store-search-charts-scraper)
- [App Store Reviews Scraper - Export iOS Reviews, All Countries](https://apify.com/pandabear/app-store-reviews-scraper)
- [Sitemap Checker & Extractor - SEO Index Audit (404, noindex)](https://apify.com/pandabear/sitemap-seo-auditor)
- [Bulk WHOIS Lookup - Domain Expiry & Availability Checker](https://apify.com/pandabear/bulk-whois-domain-checker)
- [Wayback Machine Scraper - Find Lost 404 Pages & Redirect Map](https://apify.com/pandabear/wayback-lost-url-finder)

#### Keywords

trending topics today, multi-platform trends, google trends, hacker news, wikipedia trending, github trending, bluesky trending, baidu, toutiao, heat score, cross-platform clusters, daily trend brief

***

#### 中文说明

##### 这个工具做什么

一次运行汇总多个公开平台的今日热点：Google Trends、Hacker News、Wikipedia、GitHub、Bluesky、Mastodon、百度、头条；YouTube / X / Reddit 仅在你自己提供密钥时启用。输出统一字段、热度分，以及跨平台关键词簇。可选的内容选题用**你自己的** AI 密钥生成，密钥不会写入数据集或日志，模型费用由你的供应商另计。它不是深度版 Google Trends（按时间、分地区、相关查询），商店里已有专门做这一项、用量很大的 Actor。

##### 价格

每次启动 $0.005；每 1,000 条热点 $0.50；每条 AI 选题 $0.002（需自备密钥）。6 个来源 × 10 条的每日任务大约 $0.035。

More tools by pdbear: https://apify.com/pandabear · https://pdbear.com

# Actor input Schema

## `sources` (type: `array`):

Platforms to collect trends from. YouTube, X and Reddit are used only if you add your own API credentials below.

## `maxItemsPerSource` (type: `integer`):

How many top trends to keep from each source list.

## `countries` (type: `array`):

Two-letter country codes, e.g. US, GB, IN, JP, DE, BR.

## `wikipediaLanguages` (type: `array`):

Wikipedia language editions for most-read articles (yesterday), e.g. en, es, de, ja, zh.

## `keywordFilter` (type: `array`):

Keep only trends whose title or description contains one of these words (case-insensitive). Leave empty to keep everything.

## `mastodonInstance` (type: `string`):

Mastodon server whose public trends API to use.

## `subreddits` (type: `array`):

Subreddits to read the hot list from with your Reddit app credentials, e.g. popular, technology, marketing.

## `youtubeApiKey` (type: `string`):

Your own key from Google Cloud Console (YouTube Data API v3). Enables the YouTube most-popular source.

## `xBearerToken` (type: `string`):

Your own X (Twitter) API v2 bearer token with access to the trends endpoint. Enables the X source.

## `redditClientId` (type: `string`):

Client ID of your own Reddit 'script' or 'web' app (reddit.com/prefs/apps). Enables the Reddit source via the official API.

## `redditClientSecret` (type: `string`):

Client secret of your Reddit app.

## `githubToken` (type: `string`):

Optional personal access token for higher GitHub API rate limits.

## `aiProvider` (type: `string`):

Any OpenAI-compatible provider. AI suggestions run only if you enter your own API key.

## `apiKey` (type: `string`):

Your own API key for the selected provider. Leave empty to skip AI suggestions. You pay the provider directly.

## `model` (type: `string`):

Model name. Defaults: gpt-4o-mini (OpenAI), deepseek-chat (DeepSeek), grok-3-mini (xAI).

## `aiBaseUrl` (type: `string`):

Only for provider 'custom': the OpenAI-compatible base URL, e.g. https://openrouter.ai/api/v1.

## `aiTopTopics` (type: `integer`):

AI ideas are generated for the hottest cross-platform topics.

## `creatorNiche` (type: `string`):

E.g. 'personal finance for Gen Z', 'AI tools', 'fitness'. Helps the AI find your angle.

## `contentPlatform` (type: `string`):

E.g. 'TikTok', 'YouTube Shorts', 'X thread', '小红书笔记'.

## `contentLanguage` (type: `string`):

Language for titles, hooks and scripts, e.g. English, 中文, Español.

## Actor input object example

```json
{
  "sources": [
    "googleTrends",
    "hackernews",
    "wikipedia",
    "github",
    "bluesky",
    "mastodon",
    "baidu",
    "toutiao"
  ],
  "maxItemsPerSource": 10,
  "countries": [
    "US"
  ],
  "wikipediaLanguages": [
    "en"
  ],
  "mastodonInstance": "mastodon.social",
  "subreddits": [
    "popular"
  ],
  "aiProvider": "openai",
  "aiTopTopics": 5
}
```

# Actor output Schema

## `trends` (type: `string`):

Platform, rank, title, heat score, metric, URL and time for every trend.

## `clusters` (type: `string`):

Keywords trending on several platforms at once, with total heat and example headlines.

## `ai` (type: `string`):

Only when you supplied your own AI API key.

## `summary` (type: `string`):

Per-source status, counts, top trends overall and clusters.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "sources": [
        "googleTrends",
        "hackernews",
        "wikipedia",
        "github",
        "bluesky",
        "mastodon",
        "baidu",
        "toutiao"
    ],
    "countries": [
        "US"
    ],
    "wikipediaLanguages": [
        "en"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pandabear/trending-topics-aggregator").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "sources": [
        "googleTrends",
        "hackernews",
        "wikipedia",
        "github",
        "bluesky",
        "mastodon",
        "baidu",
        "toutiao",
    ],
    "countries": ["US"],
    "wikipediaLanguages": ["en"],
}

# Run the Actor and wait for it to finish
run = client.actor("pandabear/trending-topics-aggregator").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "sources": [
    "googleTrends",
    "hackernews",
    "wikipedia",
    "github",
    "bluesky",
    "mastodon",
    "baidu",
    "toutiao"
  ],
  "countries": [
    "US"
  ],
  "wikipediaLanguages": [
    "en"
  ]
}' |
apify call pandabear/trending-topics-aggregator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pandabear/trending-topics-aggregator"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7s4bjuvNxtVwqkDid/builds/FkYwXMAeiajyJswuh/openapi.json
