# GitHub Profile Repos API (https://www.socialcrawl.dev/platforms/github/profile-repos)

> Returns the public repositories owned by the user under `data.items[]` — each entry includes `id`, `name`, `full_name`, `description`, `language`, `stargazers_count`, `forks_count`, `created_at`, and `pushed_at`. Sortable by `created`, `updated`, `pushed`, or `full_name`. Use `/v1/github/repo` for a single richer repo dossier.

TL;DR: `GET /v1/github/profile/repos` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | GitHub username. |
| `type` | no | Filter — `all`, `owner`, or `member`. Defaults to `owner`. (all \| owner \| member) |
| `sort` | no | Sort field — `created`, `updated`, `pushed`, or `full_name`. Defaults to `full_name`. (created \| updated \| pushed \| full_name) |
| `direction` | no | `asc` or `desc`. Defaults to `asc` for full_name, `desc` otherwise. (asc \| desc) |
| `per_page` | no | Repos per page (1–100). Defaults to 30. |
| `page` | no | 1-indexed page number for pagination. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/github/profile/repos?handle=octocat" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a user's GitHub repositories?

Send a GET request to /v1/github/profile/repos with the username or org name in the handle parameter. SocialCrawl returns an array of that account's public repositories with stars, language, description, and last-push timestamp for each.

### What sort and filter options does it support?

Sort by updated, pushed, created, or full_name; set direction to asc or desc; filter type by all, owner, or member. These map to GitHub's list-repos parameters so the ordering matches what you see on the profile page.

### How do I paginate through a long repository list?

Use per_page to set the page size and page to walk forward. Increment page until you receive a short or empty array. SocialCrawl handles GitHub's Link-header pagination for you behind a simple page number.

### Does it include forks and archived repos?

By default it returns all public repositories the account owns or belongs to, including forks and archived repos. Each item carries a fork flag and an archived flag so you can filter them out client-side when you only want original, active work.

### How much does the GitHub Repositories API cost?

Each list request costs 1 credit on the standard tier, regardless of how many repos come back on the page. New accounts get 100 free credits with no credit card required — enough to map around 100 accounts' repo lists.

See the full GitHub API: https://www.socialcrawl.dev/platforms/github

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list all repositories for a GitHub user with an API
- What does the SocialCrawl GitHub Repositories API return?