↑ ↓ to move ↵ to open
Bluesky API · Endpoint

Bluesky Feed Generators API

Discover the popular custom feeds people use on Bluesky, with their likes.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • bluesky.feed.get_feed_generators
Response completed
{  "has_more": true,  "total_returned": 21,  "feeds": [    {      "display_name": "For You",      "like_count": 53174,      "description": "A personalized algorithmic feed based on your likes.\n\nIt finds people who liked the same posts as you, and shows you what else they've like…",      "did": "did:web:foryou.club",      "indexed_at": "2026-05-06T01:45:57.363Z",      "uri": "at://did:plc:3guzzweuqraryl3rdkimjamk/app.bsky.feed.generator/for-you"    },    {      "display_name": "Discover",      "like_count": 39492,      "description": "Trending content from your personal network",      "did": "did:web:discover.bsky.app",      "indexed_at": "2023-05-19T23:19:19.592Z",      "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"    }  ]}
Try it live, free
Input

What you send

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

FieldTypeRequiredWhat it doesExample
cursor string no Continuation cursor returned by a previous request.
limit integer no Maximum number of results to return. From 1 to 100.
max_pages integer no Maximum number of result pages to fetch. From 1 to 50.
Response

Fields it returns

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

FieldTypeWhat it isExample
feeds[].display_name string The feed's name. For You
feeds[].description string What the feed shows. A personalized algorithmic feed based on your likes. It finds p…
feeds[].like_count integer Likes on the feed. 53,174
feeds[].uri string The feed's permanent address on Bluesky. at://did:plc:3guzzweuqraryl3rdkimjamk/app.bsky.feed.generator/f…
feeds[].did string The ID of the service that runs the feed. did:web:foryou.club
feeds[].indexed_at string When Bluesky last indexed the feed. 2026-05-06T01:45:57.363Z
feeds array Feeds you can follow. 21 records
has_more boolean Whether more results are available. true
total_returned integer How many results this answer holds. 21
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_feed_generators",  "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

Use Upscrape to list the most popular custom feeds on Bluesky and what each one shows.

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

More from the Bluesky API

Questions

Bluesky Feed Generators 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 Feed Generators 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_feed_generators, 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.