Skip to content
FxEmbed

Trending topics (Bluesky)

GET
/2/trends
curl --request GET \
  --url 'https://api.fxbsky.app/2/trends?type=trending&count=20'

Returns trending topic labels and suggested topic feeds from the Bluesky public AppView, in the same envelope as FxTwitter GET /2/trends (code, timeline_type, trends, cursor). Each trend’s context includes a bsky.app URL to the topic feed when the upstream provides a link.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
type
string
default: trending
Allowed values: trending suggested
Example
trending

Trend list. trending returns Bluesky live topics first, then suggested topic feeds to fill count. suggested returns only suggested feeds. Upstream: app.bsky.unspecced.getTrendingTopics (max 25 rows per request).

count
integer
default: 20 >= 1 <= 50

Number of trends (default 20, max 50)

Responses

Section titled “Responses”

200

Section titled “200”

Trends payload

Media typeapplication/json
object
code
required
number
message
string
timeline_type
required
string
trends
required
Array<object>
object
name
required
string
rank
required
string
nullable
context
required
string
nullable
grouped_topics
Array<object>
object
name
required
string
cursor
required
object
top
required
string
nullable
bottom
required
string
nullable
Examplegenerated
{
  "code": 1,
  "message": "example",
  "timeline_type": "example",
  "trends": [
    {
      "name": "example",
      "rank": "example",
      "context": "example",
      "grouped_topics": [
        {
          "name": "example"
        }
      ]
    }
  ],
  "cursor": {
    "top": "example",
    "bottom": "example"
  }
}

400

Section titled “400”

Invalid query parameters (e.g. type or count out of allowed range)

Media typeapplication/json
object
code
required
number
Allowed values: 400
message
required
string
Example
{
  "code": 400
}

404

Section titled “404”

Trends unavailable or empty upstream list

Media typeapplication/json
object
code
required
number
message
string
timeline_type
required
string
trends
required
Array<object>
object
name
required
string
rank
required
string
nullable
context
required
string
nullable
grouped_topics
Array<object>
object
name
required
string
cursor
required
object
top
required
string
nullable
bottom
required
string
nullable
Examplegenerated
{
  "code": 1,
  "message": "example",
  "timeline_type": "example",
  "trends": [
    {
      "name": "example",
      "rank": "example",
      "context": "example",
      "grouped_topics": [
        {
          "name": "example"
        }
      ]
    }
  ],
  "cursor": {
    "top": "example",
    "bottom": "example"
  }
}

500

Section titled “500”

Upstream or processing error

Media typeapplication/json
object
code
required
number
message
string
timeline_type
required
string
trends
required
Array<object>
object
name
required
string
rank
required
string
nullable
context
required
string
nullable
grouped_topics
Array<object>
object
name
required
string
cursor
required
object
top
required
string
nullable
bottom
required
string
nullable
Examplegenerated
{
  "code": 1,
  "message": "example",
  "timeline_type": "example",
  "trends": [
    {
      "name": "example",
      "rank": "example",
      "context": "example",
      "grouped_topics": [
        {
          "name": "example"
        }
      ]
    }
  ],
  "cursor": {
    "top": "example",
    "bottom": "example"
  }
}