> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# search_issues

> Search issues and pull requests across GitHub with qualifiers, e.g. 'repo:owner/name is:issue is:open label:bug'. Use this when the repository is unknown or the filter is richer than issues_list_for_repo supports. Rate limited to 30 requests per minute.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.github.com/search/issues"}</code></div>

```python github_search_issues.py theme={null}
from charter.packs import github

result = await github.search_issues.ainvoke({"q": ...})
```

<Note>
  Requires `repo`, `read:user`. Pages by number: `page` with `per_page`.
</Note>

## Query parameters

<div className="reference-table">
  | Field                                                     | Type                                                                    | Description                                                                                                                                                                                                                                                                          |
  | --------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `perPage`                                                 | `integer`                                                               | The number of results per page (max 100). Defaults to 30. <span className="field-constraints">≥ 1; ≤ 100; defaults to `30`</span>                                                                                                                                                    |
  | `page`                                                    | `integer`                                                               | The page number of the results to fetch. Defaults to 1. <span className="field-constraints">≥ 1; defaults to `1`</span>                                                                                                                                                              |
  | `order`                                                   | [SortDirection](/charter/charter/packs/github/issues/objects#sortdirection)     | Determines whether the first search result returned is the highest number of matches (`desc`) or lowest (`asc`). Ignored unless `sort` is provided. GitHub uses `desc` when this is absent.                                                                                          |
  | `q` <span className="required" title="required">\*</span> | `string`                                                                | The query containing one or more search keywords and qualifiers, e.g. `repo:octocat/hello-world is:issue is:open label:bug`. Qualifiers narrow the search: `repo:`, `org:`, `author:`, `assignee:`, `is:open`, `is:closed`, `is:pr`, `is:issue`, `label:`, `created:&gt;2024-01-01`. |
  | `sort`                                                    | [IssueSearchSort](/charter/charter/packs/github/search/objects#issuesearchsort) | Sorts the results by the given field. Default: results are sorted by best match.                                                                                                                                                                                                     |
  | `advancedSearch`                                          | `boolean`                                                               | Set to true to use advanced search, which adds `AND`/`OR` keywords and nested parenthesised queries to the qualifier syntax.                                                                                                                                                         |
  | `searchType`                                              | `"semantic" \| "hybrid"`                                                | Which search algorithm to apply. `semantic` matches on meaning rather than keywords, `hybrid` combines both. Omit for a lexical search, which is the default.                                                                                                                        |
</div>