↑ ↓ to move ↵ to open
Bluesky API reference

Bluesky Feed Generators

bluesky.feed.get_feed_generators

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

At a glance

Endpoint ID
bluesky.feed.get_feed_generators
Price
0.75–150 credits per call; failed calls are free
Runs for up to
120 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
bluesky__feed__get_feed_generators
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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": {}}'

Input

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

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "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"    }  ]}

Fields

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

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Bluesky endpoints

Something missing or unclear? Ask the team that builds the Bluesky endpoints.