Provided by: dotnet-host-9.0_9.0.7-0ubuntu1~25.04.1_amd64 bug

dotnet package search

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

NAME

       dotnet-package-search - Searches for a NuGet package.

SYNOPSIS

              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

DESCRIPTION

       The dotnet package search command searches for a NuGet package.

ARGUMENTS

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.

OPTIONS

--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 in‐
         formation, 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 ver‐
         sions 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.

EXAMPLES

       • 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,  ignor‐
         ing  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   |

                                                   2024-10-02                           dotnet-package-search(1)