# Search for Feeds

The query feeds endpoint lets you search for feeds.

## Examples

### Querying My Feeds

```dart label="Dart"
final query = FeedsQuery(
  filter: const Filter.equal(FeedsFilterField.createdById, 'john'),
  sort: [FeedsSort.desc(FeedsSortField.createdAt)],
  limit: 10,
  watch: true,
);

final feedList = client.feedList(query);

// Page 1
final page1 = await feedList.get();

// Page 2
final page2 = await feedList.queryMoreFeeds(limit: 10);

final page1And2 = feedList.state.feeds;
```

### Querying Feeds Where I Am a Member

```dart label="Dart"
const query = FeedsQuery(
  filter: Filter.contains(FeedsFilterField.members, 'john'),
);
final feedList = client.feedList(query);
final feeds = await feedList.get();
```

### Querying feeds by name or description

```dart label="Dart"
const sportsQuery = FeedsQuery(
  filter: Filter.and([
    Filter.equal(FeedsFilterField.visibility, 'public'),
    Filter.query(FeedsFilterField.name, 'Sports'),
  ]),
);

final sportsFeedList = client.feedList(sportsQuery);
final sportsFeeds = await sportsFeedList.get();

const techQuery = FeedsQuery(
  filter: Filter.and([
    Filter.equal(FeedsFilterField.visibility, 'public'),
    Filter.query(FeedsFilterField.description, 'tech'),
  ]),
);

final techFeedList = client.feedList(techQuery);
final techFeeds = await techFeedList.get();
```

### Querying feeds by creator name

```dart label="Dart"
const query = FeedsQuery(
  filter: Filter.and([
    Filter.equal(FeedsFilterField.visibility, 'public'),
    Filter.query(FeedsFilterField.createdByName, 'Thompson'),
  ]),
);

final feedList = client.feedList(query);
final feeds = await feedList.get();
```

### A complex example

Search for `user` feeds where text matches the feed's name, description or creator's name:

```dart label="Dart"
const query = FeedsQuery(
  filter: Filter.and([
    Filter.equal(FeedsFilterField.groupId, 'user'),
    Filter.or([
      Filter.query(FeedsFilterField.name, searchQuery),
      Filter.query(FeedsFilterField.description, searchQuery),
      Filter.query(FeedsFilterField.createdByName, searchQuery),
    ]),
  ]),
);

final feedList = client.feedList(query);
final feeds = await feedList.get();
```

## Feeds Queryable Built-in Fields

| name              | type                      | description                               | supported operations                       | example                                                                                      |
| ----------------- | ------------------------- | ----------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------- |
| `id`              | string or list of strings | The ID of the feed                        | `$in`, `$eq`                               | `{ id: { $in: [ 'abc', 'xyz' ] } }`                                                          |
| `group_id`        | string or list of strings | The ID of the group this feed belongs to  | `$in`, `$eq`                               | `{ group_id: { $in: [ 'abc', 'xyz' ] } }`                                                    |
| `feed`            | string or list of strings | The fully qualified feed ID (group_id:id) | `$in`, `$eq`                               | `{ fid: { $in: [ 'abc', 'xyz' ] } }`                                                         |
| `visibility`      | string or list of strings | The visibility setting of the feed        | `$in`, `$eq`                               | `{ visibility: { $eq: 'public' } }`                                                          |
| `created_by_id`   | string or list of strings | The ID of the user who created the feed   | `$in`, `$eq`                               | `{ created_by_id: { $in: [ 'abc', 'xyz' ] } }`                                               |
| `created_by.name` | string                    | The name of the user who created the feed | `$eq`, `$q`, `$autocomplete`               | `{ 'created_by.name': { $autocomplete: 'Frank' } }`                                          |
| `name`            | string                    | The name of the feed                      | `$eq`, `$q`, `$autocomplete`               | `{ name: { $q: 'Sports' } }`                                                                 |
| `description`     | string                    | The description of the feed               | `$eq`, `$q`, `$autocomplete`               | `{ description: { $autocomplete: 'tech' } }`                                                 |
| `member_count`    | number                    | The number of members in this feed        | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte` | `{ member_count: { $gt: 100 } }`                                                             |
| `members`         | list of strings           | The list of members in this feed          | `$in`                                      | `{ members: { $in: [ 'bob', 'alice' ] } }`                                                   |
| `following_count` | number                    | The number of feeds this feed follows     | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte` | `{ following_count: { $gt: 100 } }`                                                          |
| `following_feeds` | list of strings           | The list of feeds this feed follows       | `$in`                                      | `{ following_feeds: { $in: [ 'feed1', 'feed2' ] } }`                                         |
| `follower_count`  | number                    | The number of followers of this feed      | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte` | `{ follower_count: { $gt: 100 } }`                                                           |
| `created_at`      | string, RFC3339 timestamp | The time the feed was created             | `$eq`, `$gt`, `$lt`, `$gte`, `$lte`        | `{ created_at: { $gte: '2023-12-04T09:30:20.45Z' } }`                                        |
| `updated_at`      | string, RFC3339 timestamp | The time the feed was updated             | `$eq`, `$gt`, `$lt`, `$gte`, `$lte`        | `{ updated_at: { $gte: '2023-12-04T09:30:20.45Z' } }`                                        |
| `filter_tags`     | list of strings           | Tags for filtering the feed               | `$eq`, `$contains`, `$in`                  | `{ filter_tags: { $in: [ 'sports', 'news' ] } }`                                             |
| `near`            | object                    | GEO point and distance (km) to filter by  | `$eq`                                      | `{ near: { $eq: { lat: 40.0, lng: -74.0, distance: 200 } } }`                                |
| `within_bounds`   | object                    | GEO bounding box to filter by             | `$eq`                                      | `{ within_bounds: { $eq: { ne_lat: 40.0, ne_lng: -115.0, sw_lat: 32.0, sw_lng: -125.0 } } }` |

Filter expressions can be combined using `$or` and `$and` operators as well.

Feeds can be sorted by `created_at`, `updated_at`, `member_count`, `follower_count`, and `following_count`.

Be sure to reach out to support if you need additional query feed capabilities.


---

This page was last updated at 2026-08-07T20:37:29.981Z.

For the most recent version of this documentation, visit [https://getstream.io/activity-feeds/docs/flutter/search-for-feeds/](https://getstream.io/activity-feeds/docs/flutter/search-for-feeds/).