Hanzo
OpenapiIntegrations

Finds repositories on GitHub.

Finds repositories on GitHub. This reads the PUBLIC index and returns nothing an installation unlocks: it is how you find a repository to fork, not a way…

POST /v1/integrations/github/search

Addresshttps://api.hanzo.ai/v1/integrations/github/search
MethodPOST
Operationpost_integrations_github_search
AuthAuthorization: Bearer $HANZO_API_KEY

Finds repositories on GitHub.

This reads the PUBLIC index and returns nothing an installation unlocks: it is how you find a repository to fork, not a way to see inside one. The org's own token is used only so the query is rate-limited against the installation rather than anonymously — the results are the same ones anyone would get.

Request

2 fields, body application/json (required).

FieldInTypeRequiredDescription
limitbodyintegerLimit caps the answer; 0 takes the default and anything above the ceiling is clamped rather than refused.
qbodystringQ is GitHub's own search syntax, passed through: "tetris language:go", "org:hanzoai stars:>10".

Response

StatusBodyMeaning
200githubSearchOutok

200 body — 10 fields.

FieldInTypeAlwaysDescription
countbodyintegerCount is how many hits Repos carries. It is that array's length, NOT GitHub's total_count, so it never exceeds limit and says nothing about how many more…
reposbodygithubSearchHit[]Repos are the matching repositories in GitHub's own relevance order, capped at limit.
repos[].clone_urlbodystringCloneURL is the repository's https git remote.
repos[].default_branchbodystringDefaultBranch is the branch a clone checks out.
repos[].descriptionbodystringDescription is the blurb the repository's owner wrote.
repos[].full_namebodystringFullName is the repository's "owner/repo" on GitHub.
repos[].html_urlbodystringHTMLURL is the repository's page on github.com.
repos[].languagebodystringLanguage is the primary language GitHub detected from the file mix ("Go", "TypeScript").
repos[].privatebodybooleanPrivate is GitHub's visibility flag, passed through.
repos[].starsbodyintegerStars is GitHub's stargazers_count as the SEARCH INDEX held it when the query ran — a snapshot, not a live count off the repository.

Failure carries the platform error shape — see Errors.

Examples

hanzo integrations github search

Integrations API · All Hanzo APIs · Interactive reference

How is this guide?

On this page