dotnet-package-search - Man Page

This article applies to: ✔️ .NET 8.0.2xx SDK and later versions

dotnet package search <SEARCH TERM> [--configfile <FILE>] [--exact-match] [--format <FORMAT OPTION>]
    [--interactive] [--prerelease] [--skip <NUMBER>] [--source <SOURCE>] [--take <NUMBER>]
    [--verbosity <VERBOSITY VALUE>]

dotnet package search -h|--help

The dotnet package search command searches for a NuGet package.

• search terms

  Specifies the search term to filter results. Use this argument to search for packages matching the provided query. Example: dotnet package search json.

• --configfile

  The NuGet configuration file. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see Common NuGet configurations.

• --exact-match

  This option narrows the search to only include packages whose IDs exactly match the specified search term, effectively filtering out any partial matches. It provides a concise list of all available versions for the identified package. Causes --take and --skip options to be ignored. Utilize this option to display all available versions of a specified package.

• --format

  The format options are table and json. The default is table.

• --interactive

  Allows the command to stop and wait for user input or action (for example to complete authentication).

• --prerelease

  Allow prerelease packages to be shown.

• --skip

  The number of results to skip, for pagination. The default value is 0.

• --source <SOURCE>

  The package source to search. You can pass multiple –source options to search multiple package sources.

• --take

  The number of results to return. The default value is 20.

• --verbosity

  Display this amount of details in the output: normal, minimal, or detailed. The default is normal.

• -?|-h|--help

  Prints out a description of how to use the command.

• Search NuGet.org for packages that match the search term “Newtonsoft.Json,” and render the output as a table with up to 20 packages:

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3         |        | 3,829,822,911   |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
      |---------------------------------------------|----------------|--------|-----------------|
      | Microsoft.AspNetCore.Mvc.NewtonsoftJson     | 7.0.12         |        | 317,067,823     |
      |---------------------------------------------|----------------|--------|-----------------|
      ...

• Search NuGet.org for packages that match the search term “Newtonsoft.Json,” and render the output as json.

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --format json

      {
      "version": 2,
      "problems": [],
      "searchResult": [
          {
          "sourceName": "https://api.nuget.org/v3/index.json",
          "packages": [
              {
              "id": "Newtonsoft.Json",
              "latestVersion": "13.0.3",
              "totalDownloads": 4456137550,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Bson",
              "latestVersion": "1.0.2",
              "totalDownloads": 655362732,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Schema",
              "latestVersion": "3.0.15",
              "totalDownloads": 46062119,
              "owners": "jamesnk, newtonsoft"
              },
              {
              "id": "Microsoft.AspNetCore.Mvc.NewtonsoftJson",
              "latestVersion": "8.0.3",
              "totalDownloads": 372202749,
              "owners": "aspnet, dotnetframework, Microsoft"
              },
              {
              "id": "Newtonsoft.Json.Encryption",
              "latestVersion": "2.2.0",
              "totalDownloads": 113101,
              "owners": "simoncropp"
              }
          ]
          }
      ]
      }

• Search NuGet.org for packages using the search term “Newtonsoft.Json,” show only two results, and skip the first packages in the search result:

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --skip 1 --take 2

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |

• Search for packages that exactly match “Newtonsoft.Json” and list all available versions of it, ignoring any packages that contain “Newtonsoft.Json” as a part of their name or description but don’t match it exactly:

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --exact-match

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Version | Owners | Downloads       |
      |---------------------------------------------|---------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3  |        | 3,829,822,911   |