# Bluesky Trending Topics (`jrpbuilds/bluesky-trending-topics`) Actor Get trending topics from Bluesky in real-time — no auth needed. Uses the official AT Protocol public API. - **URL**: https://apify.com/jrpbuilds/bluesky-trending-topics.md - **Developed by:** [Jake Paine](https://apify.com/jrpbuilds) (community) - **Categories:** Social media, News, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bluesky Trending Topics [![Apify Store](https://img.shields.io/badge/Apify-Store-blue)](https://apify.com/actors) [![AT Protocol](https://img.shields.io/badge/AT%20Protocol-API-purple)](https://atproto.com) ![Node.js](https://img.shields.io/badge/Node.js-20%2B-brightgreen) Get **trending topics** from Bluesky in real-time — no auth needed. Uses the official AT Protocol public API. No auth required — uses the public Bluesky API Official endpoint — no anti-bot concerns $1/1K trends — affordable trend intelligence --- ### Quick Start 1. Set `maxTrends` (1-25, default: 10) 2. (Optional) Configure filters — categories, minimum post count, output format 3. Click **Run** 4. Receive structured trending topics in seconds **Minimal input:** ```json {} ```` **Customised input:** ```json { "maxTrends": 15, "includePostCounts": true, "categories": ["technology"], "minPostCount": 1000, "outputFormat": "flat" } ``` *** ### Features - **Real-time data** — trends as they happen, no caching delays - **No authentication needed** — public endpoint - **Configurable limits** — fetch 1 to 25 trending topics per run - **Category filtering** — narrow results to specific categories - **Post count filtering** — only trends above a popularity threshold - **Two output formats** — flat array or detailed with metadata - **Fallback endpoint** — alternative endpoint if the primary is unavailable - **Retry logic** — exponential backoff for transient failures *** ### Input Parameters | Parameter | Type | Default | Max | Description | |-----------|------|---------|-----|-------------| | `maxTrends` | integer | 10 | 25 | Number of trending topics to fetch | | `includePostCounts` | boolean | true | — | Include approximate post count (when available) | | `includeSampleActors` | boolean | false | — | Sample accounts posting about each trend | | `categories` | string\[] | \[] | — | Filter by categories (e.g., `["technology", "politics"]`). Empty = all. | | `minPostCount` | integer | 0 | — | Minimum post count threshold (0 = no filter) | | `outputFormat` | string | "flat" | — | `"flat"` = array of trends, `"detailed"` = wrapped with metadata | #### Input Example ```json { "maxTrends": 10, "includePostCounts": true, "includeSampleActors": false, "categories": [], "minPostCount": 0, "outputFormat": "flat" } ``` *** ### Output Format #### Flat (default) Returns a JSON array of trend objects, one per trending topic: ```json [ { "rank": 1, "topic": "ai-agents", "displayName": "AI Agents", "postCount": 15420, "category": "technology", "status": "hot", "startedAt": "2026-07-04T18:30:00.000Z", "link": "https://bsky.app/profile/trending.bsky.app/feed/abc123", "scrapedAt": "2026-07-04T22:45:00.000Z" }, { "rank": 2, "topic": "bluesky-anniversary", "displayName": "Bluesky Anniversary", "postCount": 8750, "category": "pop-culture", "status": "warm", "startedAt": "2026-07-04T12:00:00.000Z", "link": "https://bsky.app/profile/trending.bsky.app/feed/def456", "scrapedAt": "2026-07-04T22:45:00.000Z" } ] ``` #### Detailed Returns an object with a `metadata` block and a `trends` array: ```json { "metadata": { "scrapedAt": "2026-07-04T22:45:00.000Z", "source": "app.bsky.unspecced.getTrends", "totalTrends": 15, "filters": { "categories": null, "minPostCount": null } }, "trends": [ { "rank": 1, "topic": "ai-agents", "displayName": "AI Agents", "postCount": 15420, "category": "technology", "status": "hot", "startedAt": "2026-07-04T18:30:00.000Z", "link": "https://bsky.app/profile/trending.bsky.app/feed/abc123", "scrapedAt": "2026-07-04T22:45:00.000Z", "sampleActors": [ { "did": "did:plc:abc123", "handle": "techuser.bsky.social", "displayName": "Tech User" } ] } ] } ``` *** ### Comparison vs Generic Bluesky Scrapers | Feature | Generic Post Scrapers | Bluesky Trending Topics | |---------|----------------------|------------------------| | Trending topics | ❌ Not available | ✅ Yes | | Posts/profiles | ✅ Yes | ❌ Not included | | Auth required | Usually | ❌ No | | Anti-bot risk | Moderate | ❌ None (official API) | | Use case | Bulk data collection | Trend intelligence | ### Technical Notes - **API endpoint:** `app.bsky.unspecced.getTrends` via `https://public.api.bsky.app` - **Rate limits:** ~3,000 requests/hour typical for the public AppView endpoint - **Runtime:** Node.js 20+ - **Dependencies:** `apify` SDK v3 only - **No browser required** — pure HTTP API calls - **Fallback endpoint:** `app.bsky.unspecced.getTrendingTopics` (lighter-weight structure) #### Data Freshness Data is fetched live from Bluesky on each run. There are no caching layers between this actor and the Bluesky API, so results always reflect the current trending state. *** ### FAQ **Q: Do I need a Bluesky account?**\ No. The API endpoint used is fully public and requires no authentication. **Q: Can I get more than 25 trends?**\ The Bluesky API caps results at 25 per request. For a larger set, run the actor multiple times — but note that the API returns the top N, not paginated results. **Q: Why are some fields missing from the output?**\ The Bluesky API may not include all fields for every trend. For example, `postCount` and `category` are optional in the API response. The actor gracefully handles missing fields. **Q: Which categories are available?**\ The categories depend on what Bluesky returns. Common categories include `technology`, `pop-culture`, `politics`, `sports`, `news`, and more. **Q: What does "status" mean?**\ The Bluesky API assigns a status label to each trend, such as `hot` (rapidly growing engagement) or `warm` (steady engagement). *** # Actor input Schema ## `maxTrends` (type: `integer`): Number of trending topics to return (max 25) ## `includePostCounts` (type: `boolean`): Include estimated post count per trend ## `includeSampleActors` (type: `boolean`): Include sample accounts posting about each trend ## `categories` (type: `array`): Filter to specific categories (e.g., \['technology', 'politics']). Empty = all categories. ## `minPostCount` (type: `integer`): Minimum post count threshold. 0 = no filter. ## `outputFormat` (type: `string`): 'flat' = array of trends, 'detailed' = includes metadata wrapper ## Actor input object example ```json { "maxTrends": 10, "includePostCounts": true, "includeSampleActors": false, "categories": [], "minPostCount": 0, "outputFormat": "flat" } ``` # Actor output Schema ## `trends` (type: `string`): Array of trending topics with rank, category, post counts, and timestamps # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "categories": [] }; // Run the Actor and wait for it to finish const run = await client.actor("jrpbuilds/bluesky-trending-topics").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "categories": [] } # Run the Actor and wait for it to finish run = client.actor("jrpbuilds/bluesky-trending-topics").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "categories": [] }' | apify call jrpbuilds/bluesky-trending-topics --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jrpbuilds/bluesky-trending-topics", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bluesky Trending Topics", "description": "Get trending topics from Bluesky in real-time — no auth needed. Uses the official AT Protocol public API.", "version": "1.0", "x-build-id": "2jLTarZeLOSLO3uwR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jrpbuilds~bluesky-trending-topics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jrpbuilds-bluesky-trending-topics", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jrpbuilds~bluesky-trending-topics/runs": { "post": { "operationId": "runs-sync-jrpbuilds-bluesky-trending-topics", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jrpbuilds~bluesky-trending-topics/run-sync": { "post": { "operationId": "run-sync-jrpbuilds-bluesky-trending-topics", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxTrends": { "title": "Maximum Trends to Return", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of trending topics to return (max 25)", "default": 10 }, "includePostCounts": { "title": "Include Post Counts", "type": "boolean", "description": "Include estimated post count per trend", "default": true }, "includeSampleActors": { "title": "Include Sample Actors", "type": "boolean", "description": "Include sample accounts posting about each trend", "default": false }, "categories": { "title": "Filter by Categories", "type": "array", "description": "Filter to specific categories (e.g., ['technology', 'politics']). Empty = all categories.", "items": { "type": "string" }, "default": [] }, "minPostCount": { "title": "Minimum Post Count Filter", "minimum": 0, "type": "integer", "description": "Minimum post count threshold. 0 = no filter.", "default": 0 }, "outputFormat": { "title": "Output Format", "enum": [ "flat", "detailed" ], "type": "string", "description": "'flat' = array of trends, 'detailed' = includes metadata wrapper", "default": "flat" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```