Search

You can use Octokit to search for different sorts of data available on the GitHub or GitHub Enterprise server:

issues
repositories
code
users

Search Issues

A common scenario is to search for issues to triage:

// you can also specify a search term here
var request = new SearchIssuesRequest();

// you can add individual repos to focus your search
request.Repos.Add("aspnet/dnx");
request.Repos.Add("aspnet", "dnvm");

// or use a series of repositories
request.Repos = new RepositoryCollection {
    "aspnet/dnx",
    "aspnet/dnvm"
};

request.Repos = new RepositoryCollection {
    { "aspnet", "dnx" },
    { "aspnet", "dnvm" }
};

There's many other options available here to tweak your search criteria:

// if you're searching for a specific term, you can
// focus your search on specific criteria
request.In = new[] {
    IssueInQualifier.Title,
    IssueInQualifier.Body
};

// you can restrict your search to issues or pull requests
request.Type = IssueTypeQualifier.Issue;

// you can filter on when the issue was created or updated
var aWeekAgo = DateTime.Now.Subtract(TimeSpan.FromDays(7));
request.Created = new DateRange(aWeekAgo, SearchQualifierOperator.GreaterThan)

// you can search for issues created by, assigned to
// or mentioning a specific user
request.Author = "davidfowl";
request.Assignee = "damianedwards";
request.Mentions = "shiftkey";
request.Commenter = "haacked";

// rather than setting all these, you can use this to find
// all the above for a specific user with this one-liner
request.Involves = "davidfowl";

// by default this will search on open issues, set this if
// you want to get all issues
request.State = ItemState.All;
// or to just search closed issues
request.State = ItemState.Closed;

There's other options available to control how the results are returned:

request.SortField = IssueSearchSort.Created;
request.Order = SortDirection.Descending;

// 100 results per page as default
request.PerPage = 30;

// set this when you want to fetch subsequent pages
request.Page = 2;

Once you've set the right parameters, execute the request:

var repos = await client.Search.SearchIssues(request);

Console.WriteLine("Query has {0} matches.", repos.TotalCount);
Console.WriteLine("Response has {0} items.", repos.Items.Count);

Search Pull Requests

Another scenario to consider is how to search broadly:

var threeMonthsAgoIsh = DateTime.Now.Subtract(TimeSpan.FromDays(90));

// search for a specific term
var request = new SearchIssuesRequest("linux")
{
    // only search pull requests
    Type = IssueTypeQualifier.PR,

    // search across open and closed PRs
    State = ItemState.All,

    // search repositories which contain code
    // matching a given language
    Language = Language.CSharp,

    // focus on pull requests updated recently
    Updated = new DateRange(threeMonthsAgoIsh, SearchQualifierOperator.GreaterThan)
};

Search Repositories

Finding repositories via various criteria.

// Initialize a new instance of the SearchRepositoriesRequest class
var request = new SearchRepositoriesRequest();

// you can also specify a search term here
var request = new SearchRepositoriesRequest("bootstrap");

Now we can further filter our search.

var request = new SearchRepositoriesRequest("mvc client side framework")
{
    // lets find a library with over 1k stars
    Stars = Range.GreaterThan(1000);
    
    // we can specify how big we want the repo to be in kilobytes
    Size = Range.GreaterThan(1);
    
    // maybe we want the library to have over 50 forks?
    Forks = Range.GreaterThan(50);
    
    // we may want to include or exclude the forks too
    Fork = ForkQualifier.IncludeForks;
    
    // how about we restrict the language the library is written in?
    Language = Language.JavaScript;
    
    // maybe we want to include searching in the read me?
    In = new[] { InQualifier.Readme };
    
    // how about only the name of the project?
    In = new[] { InQualifier.Name };
    
    // or search the readme, name or description?
    In = new[] { InQualifier.Readme, InQualifier.Description, InQualifier.Name };
    
    // how about searching for libraries created before a given date?
    Created = DateRange.GreaterThan(new DateTime(2015, 1, 1));
    
    // or after a given date?
    Created = DateRange.LessThan(new DateTime(2015, 1, 1));
    
    // or maybe the last time this repo was updated?
    Updated = DateRange.GreaterThan(new DateTime(2013, 1, 1));
    
    // or maybe updated between a given date?
    Updated = DateRange.Between(new DateTime(2012, 4, 30), new DateTime(2012, 7, 4));
    
    // we can also restrict the owner of the repo if we so wish
    User = "dhh";
};

We can also sort our results, the default sort direction is descending

var request = new SearchRepositoriesRequest("mvc client side framework")
{
    // sort by the number of stars
    SortField = RepoSearchSort.Stars;
    
    // or by forks?
    SortField = RepoSearchSort.Forks;
    
    // how about changing that sort direction?
    Order = SortDirection.Ascending;
}

Search Code

TODO

Search Users