# GitHub Repo Top Issues API (https://www.socialcrawl.dev/platforms/github/repo-top-issues)

> Composite endpoint — runs two `/search/issues` queries in parallel: `top_feature_request` (issues with `enhancement` label, sorted by reactions; falls back to top open issue by reactions if no label exists) and `top_complaint` (most-discussed open issue, sorted by comments). Returns `{ top_feature_request, top_complaint }`. 5 credits per call.

TL;DR: `GET /v1/github/repo/top-issues` costs 5 credits 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/top-issues?url=https%3A%2F%2Fgithub.com%2Ffacebook%2Freact" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the GitHub Top Issues API do?

It reads a repository's issues and uses AI to pick the single top feature request and the single top complaint, returning both in one call with the supporting issues. It turns a noisy issue tracker into a two-line product signal.

### How do I call the top-issues endpoint?

Send a GET request to /v1/github/repo/top-issues with the repository URL in the url parameter. SocialCrawl pulls the issues upstream, runs the AI ranking, and returns the top feature request and top complaint with links to the source issues.

### How is this different from listing repo issues myself?

The repo issues endpoint gives you the raw list — you still have to read and judge every issue. This endpoint does that judgement with AI and hands you the verdict, which GitHub's own REST API does not offer in a single call.

### What can I use the top feature request and complaint for?

Competitive teardown, roadmap research, and product positioning. Run it on a competitor's repo to see what their users most want and most dislike, then pair it with the dossier endpoint for the full project picture.

### How much does the GitHub Top Issues API cost?

This is an advanced endpoint at 5 credits per call, since it pulls issues and runs an AI ranking pass over them. New accounts get 100 free credits with no credit card required — enough to analyse 20 repositories before you pay.

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 find a GitHub repo's top feature request and complaint with AI
- What is the SocialCrawl GitHub Top Issues API?