GitHub Projects API
List a GitHub user's public project boards, with each project's title, description, link, open or closed state and creation and update dates.
- Endpoint
- POST /github/list-projects
- Price
- 1 credit per request
- SDK
- client.github.listProjects()
- MCP tool
- github_list_projects
curl -X POST "https://api.bridgly.app/github/list-projects" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "username": "torvalds", "count": 10}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/github/list-projects", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "username": "torvalds", "count": 10, },)data = response.json()const response = await fetch("https://api.bridgly.app/github/list-projects", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "username": "torvalds", "count": 10 }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.github.listProjects({ username: "torvalds", count: 10});if (res.type === "success") { console.log(res.data);}What does the GitHub Projects API return?
GitHub projects API: list any user’s public GitHub Projects boards as JSON, with each project’s title, description, link, open or closed state and dates. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.
Request body
usernamestringrequired- GitHub username (login), or the profile link, e.g. "torvalds" or "https://github.com/torvalds".
countinteger · 1–10 · default 10- Number of results to return (1–10). Defaults to 10.
cursorstring- The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
Example response
{ "timeMs": 1840, "creditsCost": 1, "data": { "nextCursor": "string", "username": "string", "projects": [ { "id": "string", "number": 0, "title": "string", "shortDescription": "string", "url": "string", "closed": true, "public": true, "createdAt": "string", "updatedAt": "string" } ] }}What can you build with the GitHub Projects API?
Follow roadmaps
Track the public project boards maintainers use to plan work.
Show planning work
Display someone’s public projects next to their repositories.
Spot active projects
Find open projects that were updated recently.
GitHub Projects API questions
How do I list a GitHub user’s projects?
Send the username. Each public project board comes back with its title, description, link, whether it is open or closed, and its creation and update dates.
Does it return the items on each board?
No. It lists the boards themselves, so you can see which projects a user runs and when they were last updated.
How do I get all of a user’s GitHub projects?
Each call returns up to 10 projects and a nextCursor. Send it back as cursor to get the next page; it is null when there are no more.
How do I use the GitHub Projects API?
Send a POST request to https://api.bridgly.app/github/list-projects with username in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.github.listProjects(). AI agents connected to Bridgly over MCP can call the github_list_projects tool.
How much does the GitHub Projects API cost?
Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.
More GitHub endpoints
The same API key works on every endpoint. See all GitHub API endpoints.
- GitHub User Search API→Find GitHub developers and organizations by location, language, followers and join date. Get bios and repository counts with the GitHub User Search API.
- GitHub Profile API→GitHub user API: get any GitHub profile by username as JSON, with name, bio, company, location, website, followers, repo count and pinned repositories.
- GitHub Contributions API→GitHub contributions API: get any user’s contribution graph with daily counts, plus total commits, issues, pull requests and reviews for a date range.
- GitHub Repositories API→GitHub repositories API: list any user’s public repos with description, language, stars, forks and watchers, sorted by last push, update, name or stars.
Try the GitHub Projects API
100 free credits on business email, no card. Your first call takes a minute.