---
title: "Channels by activity"
method: GET
path: "/v2/farcaster/channel/trending/"
tags: ["Channel"]
---

# Channels by activity

`GET /v2/farcaster/channel/trending/`

Returns a list of trending channels based on activity

## Query parameters

- `time_window` '1d' | '7d' | '30d'
- `limit` integer
- `cursor` string

## Response `200`

Success

- TrendingChannelResponse
  - `channels` ChannelActivity[], required
    - `cast_count_1d` string, required
    - `cast_count_30d` string, required
    - `cast_count_7d` string, required
    - `channel` Channel, required
      - `created_at` string, date-time, required
      - `description` string
      - `description_mentioned_profiles` UserDehydrated[]
        - `custody_address` string — Ethereum address
        - `display_name` string, nullable
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `object` 'user_dehydrated', required
        - `pfp_url` string, nullable
        - `score` number
        - `username` string
      - `description_mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs.
        - `end` number, required
        - `start` number, required
      - `external_link` object — Channel's external link.
        - `title` string
        - `url` string
      - `follower_count` number — Number of followers the channel has.
      - `hosts` User[]
        - `auth_addresses` object[], required
          - `address` string, required — Ethereum address
          - `app` UserDehydrated, required
            - `custody_address` string — Ethereum address
            - `display_name` string, nullable
            - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
            - `object` 'user_dehydrated', required
            - `pfp_url` string, nullable
            - `score` number
            - `username` string
        - `custody_address` string, required — Ethereum address
        - `display_name` string, nullable
        - `experimental` object
          - `deprecation_notice` string
          - `neynar_user_score` number, double, required — Score that represents the probability that the account is not spam.
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `follower_count` integer, required — The number of followers the user has.
        - `following_count` integer, required — The number of users the user is following.
        - `object` 'user', required
        - `pfp_url` string, nullable — The URL of the user's profile picture
        - `pro` object
          - `expires_at` string, date-time, required
          - `status` 'subscribed' | 'unsubscribed', required — The subscription status of the user
          - `subscribed_at` string, date-time, required
        - `profile` object, required
          - `banner` object
            - `url` string, uri — The URL of the user's banner image
          - `bio` object, required
            - `mentioned_channels` ChannelDehydrated[]
              - …
            - `mentioned_channels_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
              - …
            - `mentioned_profiles` UserDehydrated[]
              - …
            - `mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
              - …
            - `text` string, required
          - `live_at` object
            - `is_live` boolean, required
            - `updated_at` string, date-time, required
            - `url` string, required — The URL of the user's current live activity
          - `location` Location — Coordinates and place names for a location
            - `address` LocationAddress
              - …
            - `latitude` number, double, required
            - `longitude` number, double, required
            - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
        - `registered_at` string, date-time, required
        - `score` number, double — Score that represents the probability that the account is not spam.
        - `username` string, required
        - `verifications` EthAddress[], required
        - `verified_accounts` object[], required
          - `platform` 'x' | 'github'
          - `username` string
        - `verified_addresses` object, required
          - `eth_addresses` EthAddress[], required — List of verified Ethereum addresses of the user sorted by oldest to most recent.
          - `primary` object, required
            - `eth_address` string, required — Ethereum address
            - `sol_address` string, required — Solana address
          - `sol_addresses` SolAddress[], required — List of verified Solana addresses of the user sorted by oldest to most recent.
        - `viewer_context` UserViewerContext — Adds context on the viewer's follow relationship with the user.
          - `blocked_by` boolean, required — Indicates if the viewer is blocked by the user.
          - `blocking` boolean, required — Indicates if the viewer is blocking the user.
          - `followed_by` boolean, required — Indicates if the viewer is followed by the user.
          - `following` boolean, required — Indicates if the viewer is following the user.
      - `id` string, required
      - `image_url` string
      - `lead` User
        - `auth_addresses` object[], required
          - `address` string, required — Ethereum address
          - `app` UserDehydrated, required
            - `custody_address` string — Ethereum address
            - `display_name` string, nullable
            - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
            - `object` 'user_dehydrated', required
            - `pfp_url` string, nullable
            - `score` number
            - `username` string
        - `custody_address` string, required — Ethereum address
        - `display_name` string, nullable
        - `experimental` object
          - `deprecation_notice` string
          - `neynar_user_score` number, double, required — Score that represents the probability that the account is not spam.
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `follower_count` integer, required — The number of followers the user has.
        - `following_count` integer, required — The number of users the user is following.
        - `object` 'user', required
        - `pfp_url` string, nullable — The URL of the user's profile picture
        - `pro` object
          - `expires_at` string, date-time, required
          - `status` 'subscribed' | 'unsubscribed', required — The subscription status of the user
          - `subscribed_at` string, date-time, required
        - `profile` object, required
          - `banner` object
            - `url` string, uri — The URL of the user's banner image
          - `bio` object, required
            - `mentioned_channels` ChannelDehydrated[]
              - …
            - `mentioned_channels_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
              - …
            - `mentioned_profiles` UserDehydrated[]
              - …
            - `mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
              - …
            - `text` string, required
          - `live_at` object
            - `is_live` boolean, required
            - `updated_at` string, date-time, required
            - `url` string, required — The URL of the user's current live activity
          - `location` Location — Coordinates and place names for a location
            - `address` LocationAddress
              - …
            - `latitude` number, double, required
            - `longitude` number, double, required
            - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
        - `registered_at` string, date-time, required
        - `score` number, double — Score that represents the probability that the account is not spam.
        - `username` string, required
        - `verifications` EthAddress[], required
        - `verified_accounts` object[], required
          - `platform` 'x' | 'github'
          - `username` string
        - `verified_addresses` object, required
          - `eth_addresses` EthAddress[], required — List of verified Ethereum addresses of the user sorted by oldest to most recent.
          - `primary` object, required
            - `eth_address` string, required — Ethereum address
            - `sol_address` string, required — Solana address
          - `sol_addresses` SolAddress[], required — List of verified Solana addresses of the user sorted by oldest to most recent.
        - `viewer_context` UserViewerContext — Adds context on the viewer's follow relationship with the user.
          - `blocked_by` boolean, required — Indicates if the viewer is blocked by the user.
          - `blocking` boolean, required — Indicates if the viewer is blocking the user.
          - `followed_by` boolean, required — Indicates if the viewer is followed by the user.
          - `following` boolean, required — Indicates if the viewer is following the user.
      - `member_count` integer
      - `moderator` User
        - `auth_addresses` object[], required
          - `address` string, required — Ethereum address
          - `app` UserDehydrated, required
            - `custody_address` string — Ethereum address
            - `display_name` string, nullable
            - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
            - `object` 'user_dehydrated', required
            - `pfp_url` string, nullable
            - `score` number
            - `username` string
        - `custody_address` string, required — Ethereum address
        - `display_name` string, nullable
        - `experimental` object
          - `deprecation_notice` string
          - `neynar_user_score` number, double, required — Score that represents the probability that the account is not spam.
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `follower_count` integer, required — The number of followers the user has.
        - `following_count` integer, required — The number of users the user is following.
        - `object` 'user', required
        - `pfp_url` string, nullable — The URL of the user's profile picture
        - `pro` object
          - `expires_at` string, date-time, required
          - `status` 'subscribed' | 'unsubscribed', required — The subscription status of the user
          - `subscribed_at` string, date-time, required
        - `profile` object, required
          - `banner` object
            - `url` string, uri — The URL of the user's banner image
          - `bio` object, required
            - `mentioned_channels` ChannelDehydrated[]
              - …
            - `mentioned_channels_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
              - …
            - `mentioned_profiles` UserDehydrated[]
              - …
            - `mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
              - …
            - `text` string, required
          - `live_at` object
            - `is_live` boolean, required
            - `updated_at` string, date-time, required
            - `url` string, required — The URL of the user's current live activity
          - `location` Location — Coordinates and place names for a location
            - `address` LocationAddress
              - …
            - `latitude` number, double, required
            - `longitude` number, double, required
            - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
        - `registered_at` string, date-time, required
        - `score` number, double — Score that represents the probability that the account is not spam.
        - `username` string, required
        - `verifications` EthAddress[], required
        - `verified_accounts` object[], required
          - `platform` 'x' | 'github'
          - `username` string
        - `verified_addresses` object, required
          - `eth_addresses` EthAddress[], required — List of verified Ethereum addresses of the user sorted by oldest to most recent.
          - `primary` object, required
            - `eth_address` string, required — Ethereum address
            - `sol_address` string, required — Solana address
          - `sol_addresses` SolAddress[], required — List of verified Solana addresses of the user sorted by oldest to most recent.
        - `viewer_context` UserViewerContext — Adds context on the viewer's follow relationship with the user.
          - `blocked_by` boolean, required — Indicates if the viewer is blocked by the user.
          - `blocking` boolean, required — Indicates if the viewer is blocking the user.
          - `followed_by` boolean, required — Indicates if the viewer is followed by the user.
          - `following` boolean, required — Indicates if the viewer is following the user.
      - `moderator_fids` Fid[]
      - `name` string
      - `object` 'channel', required
      - `parent_url` string, uri
      - `pinned_cast_hash` string
      - `url` string, required
      - `viewer_context` ChannelUserContext — Adds context on the viewer's or author's role in the channel.
        - `following` boolean, required — Indicates if the user is following the channel.
        - `role` 'member' | 'moderator' | 'owner' — The role of a channel member
    - `object` 'channel_activity', required
  - `next` NextCursor, required — Returns next cursor
    - `cursor` string, nullable, required

## Other responses

- `400` — Bad Request
- `500` — Server Error

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)