Forums Commands

May 21, 2026 ยท View on GitHub

Commands for browsing and reading Kaggle discussion forums.

kaggle forums

Lists all discussion forums. Also available as kaggle forums list.

Alias: f

Usage:

kaggle forums [options]

Options:

  • -v, --csv: Print results in CSV format.
  • -q, --quiet: Suppress verbose output.

Example:

List all forums in CSV format:

kaggle forums -v

Purpose:

This command helps you discover all available discussion forums on Kaggle.

kaggle forums topics list

Lists discussion topics in a forum.

Usage:

kaggle forums topics list [FORUM] [options]

Note: kaggle forums topics (without list subcommand) is supported as a shortcut to list all topics (without forum filtering).

Arguments:

  • [FORUM]: Forum slug (e.g., 1, product-feedback). Optional.

Options:

  • --sort-by <SORT_BY>: Sort order. Valid options: hot, top, new, recent, active, relevance.
  • -s, --search <SEARCH_TERM>: Search query to filter topics.
  • --category <CATEGORY>: Filter by category. Valid options: all, forums, competitions, datasets, competition_write_ups, models, benchmarks.
  • --group <GROUP>: Filter by group. Valid options: all, owned, upvoted, bookmarked, my_activity, drafts.
  • --page-size <PAGE_SIZE>: Number of items per page.
  • --page-token <PAGE_TOKEN>: Page token for pagination.
  • -v, --csv: Print results in CSV format.
  • -q, --quiet: Suppress verbose output.

Example:

List topics in the "getting-started" forum sorted by most recent, showing 5 per page:

kaggle forums topics list getting-started --sort-by recent --page-size 5

Purpose:

This command lets you browse discussion topics within a specific forum, with filtering and sorting options.

kaggle forums topics show

Displays a topic with all comments in tree form (indented).

Usage:

kaggle forums topics show <TOPIC_REF> [options]

Arguments:

  • <TOPIC_REF>: A topic reference, which can be:
    • <forum-name>/<topic-id> (e.g., getting-started/12345)
    • <forum-name> <topic-id> (two separate arguments, where <topic-id> is passed as second argument)
    • <topic-id> (bare numeric ID)

Options:

  • --page-size <PAGE_SIZE>: Number of comments to show per page.
  • --page-token <PAGE_TOKEN>: Page token for comment pagination.
  • -v, --csv: Print results in CSV format.
  • -q, --quiet: Suppress verbose output.

Example:

Show topic 12345 from the "getting-started" forum:

kaggle forums topics show getting-started/12345

Show the same topic using two separate arguments:

kaggle forums topics show getting-started 12345

Show a topic by bare numeric ID:

kaggle forums topics show 12345

Purpose:

This command displays a full discussion topic along with all of its comments rendered in an indented tree structure.