↑ ↓ to move ↵ to open
Bluesky API · Endpoint

Bluesky Trending Topics API

Get the topics trending on Bluesky now: title, summary, category and how many posts each has.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • bluesky.feed.get_trending_topics
Response completed
{  "topics": [    {      "display_name": "Altman on accepting AI risks",      "category": "science-tech",      "description": "OpenAI CEO Sam Altman told Politico AI benefits justify some harms, unlike Anthropic's stance.",      "feed_uri": "at://did:plc:qrz3lhbyuxbeilrc6nekdqme/app.bsky.feed.generator/e28add03bb23",      "link": "/profile/did:plc:qrz3lhbyuxbeilrc6nekdqme/feed/e28add03bb23",      "post_count": 713,      "started_at": "2026-10-04T21:54:18.560479+00:00",      "status": "trending",      "topic": "e28add03bb23"    },    {      "display_name": "Data center community impacts",      "category": "science-tech",      "description": "Big Tech facilities draw criticism over pollution, noise, water use, tax breaks, and rising power bills.",      "feed_uri": "at://did:plc:qrz3lhbyuxbeilrc6nekdqme/app.bsky.feed.generator/6c19c0bde8c3",      "link": "/profile/did:plc:qrz3lhbyuxbeilrc6nekdqme/feed/6c19c0bde8c3",      "post_count": 569,      "started_at": "2026-10-03T12:14:21.902656+00:00",      "status": "trending",      "topic": "6c19c0bde8c3"    }  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
limit integer no Maximum number of results to return. From 1 to 25.
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
topics[].display_name string The topic's name. Altman on accepting AI risks
topics[].description string A short summary of the topic. OpenAI CEO Sam Altman told Politico AI benefits justify some ha…
topics[].category string The topic's category. science-tech
topics[].post_count integer Posts about the topic, as Bluesky counts them. 713
topics[].started_at string When the topic started trending. 2026-10-04T21:54:18.560479+00:00
topics[].feed_uri string The address of the topic's feed. at://did:plc:qrz3lhbyuxbeilrc6nekdqme/app.bsky.feed.generator/e…
topics[].link string The topic's page on Bluesky. /profile/did:plc:qrz3lhbyuxbeilrc6nekdqme/feed/e28add03bb23
topics[].status string Whether the topic is trending. trending
topics[].topic string Bluesky's ID for the topic. e28add03bb23
topics array Trending topics. 10 records
REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "bluesky.feed.get_trending_topics",  "input": {}}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

Using Upscrape, list the topics trending on Bluesky right now with their category and post count, biggest first.

The agent finds the endpoint, shows you the price, and runs it with your credits.
Bluesky

More from the Bluesky API

Same data, other platforms

The same data from other platforms

Questions

Bluesky Trending Topics API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
How much does the Bluesky Trending Topics API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Every input is optional; the input fields below list what each one does.

Do I need a Bluesky login?

No. It reads public Bluesky data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds bluesky.feed.get_trending_topics, checks its price and runs it with the same credits as the REST API.

Get started

Your first Bluesky call is free.

Up to 100 free credits to start, no card needed.