# GitHub Search API (https://www.socialcrawl.dev/platforms/github/search)

> Searches issues and PRs across all of GitHub via the `/search/issues` endpoint. Supports GitHub's full search syntax — qualifiers like `repo:owner/name`, `is:issue`, `is:pr`, `is:open`, `label:bug`, `created:>2026-01-01`, `author:username`, `comments:>10`. Sort by `reactions`, `comments`, `created`, or `updated`. Results land under `data.items[]` with `total_count` and `incomplete_results` siblings. Rate-limited to 30 req/min per token.

TL;DR: `GET /v1/github/search` 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 |
| --- | --- | --- |
| `query` | yes | GitHub search query (uses GitHub's qualifier syntax — see https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests). |
| `sort` | no | Sort field — `reactions`, `comments`, `created`, `updated`. Defaults to best-match relevance. (reactions \| comments \| created \| updated) |
| `order` | no | `asc` or `desc`. Defaults to `desc`. (asc \| desc) |
| `per_page` | no | Results per page (1–100). Defaults to 30. |
| `page` | no | 1-indexed page number. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/github/search?query=repo%3Avercel%2Fnext.js%20is%3Aissue%20is%3Aopen" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search GitHub issues with an API?

Send a GET request to /v1/github/search with your search string in the query parameter. SocialCrawl searches GitHub issues and pull requests and returns matching items with title, repository, author, state, and comment count.

### Can I use GitHub search qualifiers in the query?

Yes. The query parameter accepts GitHub's search qualifiers — for example repo:owner/name, label:bug, state:open, author:handle, and is:pr. Combine them in one string exactly as you would in GitHub's own search bar.

### Does it search issues, pull requests, or both?

Both, since GitHub indexes issues and pull requests together. Narrow to one type with the is:issue or is:pr qualifier in your query. Each result carries a flag indicating which type it is so you can filter client-side too.

### How do I paginate through search results?

Use per_page to set the page size and page to walk forward, incrementing page until the result array is short or empty. SocialCrawl handles GitHub's search pagination behind that page number for you.

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

Each search costs 1 credit on the standard tier, regardless of how many results come back on the page. New accounts get 100 free credits with no credit card required — enough to run around 100 searches 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 search GitHub issues and PRs with an API
- What does the SocialCrawl GitHub Search API return?