# GitHub Repo API (https://www.socialcrawl.dev/platforms/github/repo)

> Returns repository metadata — full_name, description, stars, forks, open issues, watchers, language, and creation date — mapped to the unified Author schema. A repo is a follow-able creator-like entity in this API: stars map to `author.followers`, watchers (subscribers) to `author.likes_count`, forks to `author.following`. Use `/v1/github/repo/readme`, `/v1/github/repo/releases`, and `/v1/github/repo/issues` for richer per-repo data.

TL;DR: `GET /v1/github/repo` 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 |
| --- | --- | --- |
| `url` | yes | GitHub repo URL — `https://github.com/{owner}/{repo}`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/github/repo?url=https%3A%2F%2Fgithub.com%2Foctocat%2FHello-World" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get GitHub repository data with an API?

Send a GET request to /v1/github/repo with the repository URL in the url parameter. SocialCrawl returns the repo's stars, forks, watchers, primary language, topics, license, default branch, open issue count, and description in the unified schema.

### What fields does the GitHub Repo API return?

Full name, owner, description, star count, fork count, watcher count, primary language, topics array, license, default branch, open issue count, homepage URL, archived flag, and creation and last-push timestamps.

### Can I pass an owner/repo string instead of a full URL?

Pass the full repository URL in the url parameter — for example https://github.com/owner/name. SocialCrawl parses the owner and repo for you, so there is no need to split the slug or construct an api.github.com path yourself.

### How fresh are the star and fork counts?

Star, fork, and watcher counts are pulled from GitHub at request time, so they reflect the current public value. Repeat calls may be cached briefly to save credits — the data tracks the live repository state closely.

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

Each repository request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required. Use this endpoint to benchmark project traction, then call repo/issues or repo/dossier for deeper analysis.

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 get GitHub repo stars and forks with an API
- What does the SocialCrawl GitHub Repo API return?