What it returns
Bulk statistics for public GitHub repositories from the official GitHub REST API. Three ways in: - **repos**: a list of `owner/name` or GitHub URLs - **owners**: every public repository of a user or organization, most recently pushed first - **search**: any GitHub repository search, e.g. `vector database language:rust stars:>500`
| field | meaning |. |---|---|. | `repo`, `url`, `description`, `homepage` | identity |. | `owner`, `ownerType` | user or organization |. | `stars`, `forks`, `watchers`, `openIssuesAndPRs` | counts |. | `language`, `languages` | main language and the share of code per language (%) |. | `topics`, `license` | topics and SPDX license id |. | `latestRelease` | tag, name and publish time of the latest release |. | `contributors` | number of contributors, anonymous included |. | `createdAt`, `pushedAt`, `updatedAt` | activity dates |. | `isFork`, `isArchived`, `defaultBranch`, `sizeKb` | repository state |.
Request
POST https://api.pushbuild.com/github-repo-stats/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
repos | list of strings | owner/name or GitHub URLs. |
owners | list of strings | Every public repo of these users or orgs, most recently pushed first. |
search | string | GitHub repository search, e.g. 'vector database language:rust stars:>500'. Up to 1,000 results. |
sort | string: stars, forks, updated | Order of search results. Default: "stars". |
includeForks | boolean | For owners: include forked repos. Default: false. |
includeDetails | boolean | Three extra GitHub calls per repo. Turn off for faster runs without a token. Default: true. |
maxRepos | integer | Cap on repositories returned. Default: 30. |
githubToken | string | A free personal access token with no scopes raises GitHub's limit from 60 to 5,000 requests an hour. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/github-repo-stats/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"repos": ["fastapi/fastapi", "https://github.com/pydantic/pydantic"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 repositorys. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
College Scorecard: US Colleges, Costs, Earnings by Major API
Every US college from the Department of Education College Scorecard: admission rate, SAT/ACT, tuition, net price, completion and retention, median debt and graduates' earnings, plus program-level (major) debt and earnings 1 to 5 years after graduation..
Currency Exchange Rates API
Official European Central Bank reference exchange rates for 30+ currencies, daily since 1999.
CVE Vulnerability Lookup: NVD, CISA KEV, EPSS, OSV API
Look up CVEs by ID or keyword, or check open-source packages for known vulnerabilities.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com