search_commits - Charter Docs

GET

github_search_commits.py

import asyncio

from charter.packs import github

result = asyncio.run(github.search_commits.ainvoke({"q": ...}))

Requires repo. With github.APP or github.FINE_GRAINED, needs no permission. Pages by number: page with per_page.

Query parameters

Field	Type	Description
`perPage`	`integer`	The number of results per page (max 100). Defaults to 30. ≥ 1; ≤ 100; defaults to `30`
`page`	`integer`	The page number of the results to fetch. Defaults to 1. ≥ 1; defaults to `1`
`order`	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` *	`string`	The search query, with commit qualifiers: `repo:owner/name`, `author:LOGIN`, `committer-date:>2026-01-01`, `merge:false`. A bare term searches commit messages.
`sort`	CommitSearchSort	Sorts the results by author or committer date. Absent, results come back by best match.