GitHub Repository Search API. Repos matching your search.
Repos by keyword, with exact star and fork counts. We handle the proxies, blocks and platform changes.
GitHub Repository Search API at a glance
Returns the public GitHub repositories a search finds, from keywords and GitHub's own qualifiers such as language, stars, topic and owner, by best match, most stars or latest push. Each comes with its owner, description, language, topics, license, exact star and fork counts, and when it was created and last pushed to.
GET /v1/github/search_repositories
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 24 typed fields null when unknown
- 50 repos per page, GitHub's best match
queryis all it needs, e.g.web framework language:go
Send one request. Get up to 50 repos back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtapquery = web framework language:goconst params = new URLSearchParams({
query: "web framework language:go",
});
const res = await fetch(`https://socialtap.dev/v1/github/search_repositories?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/github/search_repositories",
params={"query": "web framework language:go"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/github/search_repositories")
uri.query = URI.encode_www_form('query' => 'web framework language:go')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'query' => 'web framework language:go',
]);
$ch = curl_init('https://socialtap.dev/v1/github/search_repositories?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("query", "web framework language:go")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/github/search_repositories?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl -G 'https://socialtap.dev/v1/github/search_repositories' \
--data-urlencode 'query=web framework language:go' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [
"size_bytes"
],
"avatar_url": null,
"created_at": "2021-11-21T03:45:43Z",
"default_branch": "master",
"description": "The full-featured Golang Development Framework source code",
"full_name": "goravel/framework",
"homepage_url": "https://goravel.dev",
"id": "430266498",
"is_archived": false,
"is_fork": false,
"license": {
"name": "MIT License",
"spdx_id": "MIT"
},
"metrics": {
"fork_count": 123,
"open_issue_count": null,
"open_pull_request_count": null,
"star_count": 533,
"watcher_count": null
},
"name": "framework",
"owner": {
"avatar_url": "https://avatars.githubusercontent.com/u/93197157?v=4",
"display_name": null,
"id": "93197157",
"is_verified": null,
"url": "https://github.com/goravel",
"username": "goravel"
},
"owner_type": "organization",
"parent": null,
"platform": "github",
"platform_specific": {
"github": {
"built_by": [],
"is_disabled": false,
"is_discussions_enabled": false,
"is_issues_enabled": true,
"is_mirror": false,
"is_pages_enabled": false,
"is_projects_enabled": false,
"is_pull_requests_enabled": true,
"is_template": false,
"is_wiki_enabled": false,
"language_color": null,
"license_key": "mit",
"mirror_url": null,
"network_count": null,
"node_id": "R_kgDOGaVYgg",
"period_star_count": null,
"source": null
}
},
"programming_language": "Go",
"pushed_at": "2026-11-13T00:38:48Z",
"size_bytes": 9404416,
"topics": [
"framework",
"go",
"golang"
],
"unknown_fields": [
"platform_specific.github.built_by"
],
"updated_at": "2026-11-12T12:34:10Z",
"url": "https://github.com/goravel/framework"
},
{
"approximate_fields": [
"size_bytes"
],
"avatar_url": null,
"created_at": "2015-03-01T17:43:01Z",
"default_branch": "master",
"description": "High performance, minimalist Go web framework",
"full_name": "labstack/echo",
"homepage_url": "https://echo.labstack.com",
"id": "31504491",
"is_archived": false,
"is_fork": false,
"license": {
"name": "MIT License",
"spdx_id": "MIT"
},
"metrics": {
"fork_count": 2857,
"open_issue_count": null,
"open_pull_request_count": null,
"star_count": 32822,
"watcher_count": null
},
"name": "echo",
"owner": {
"avatar_url": "https://avatars.githubusercontent.com/u/2624634?v=4",
"display_name": null,
"id": "2624634",
"is_verified": null,
"url": "https://github.com/labstack",
"username": "labstack"
},
"owner_type": "organization",
"parent": null,
"platform": "github",
"platform_specific": {
"github": {
"built_by": [],
"is_disabled": false,
"is_discussions_enabled": true,
"is_issues_enabled": true,
"is_mirror": false,
"is_pages_enabled": false,
"is_projects_enabled": true,
"is_pull_requests_enabled": true,
"is_template": false,
"is_wiki_enabled": true,
"language_color": null,
"license_key": "mit",
"mirror_url": null,
"network_count": null,
"node_id": "MDEwOlJlcG9zaXRvcnkzMTUwNDQ5MQ==",
"period_star_count": null,
"source": null
}
},
"programming_language": "Go",
"pushed_at": "2026-11-12T09:14:31Z",
"size_bytes": 7166976,
"topics": [
"echo",
"go",
"http2"
],
"unknown_fields": [
"platform_specific.github.built_by"
],
"updated_at": "2026-11-13T01:58:39Z",
"url": "https://github.com/labstack/echo"
},
{
"approximate_fields": [
"size_bytes"
],
"avatar_url": null,
"created_at": "2012-09-12T17:13:32Z",
"default_branch": "master",
"description": "Golanger Web Framework is a lightweight framework for writing web applications in Go.",
"full_name": "golangers/framework",
"homepage_url": "https://www.golanger.com",
"id": "5783199",
"is_archived": false,
"is_fork": false,
"license": {
"name": "Other",
"spdx_id": null
},
"metrics": {
"fork_count": 71,
"open_issue_count": null,
"open_pull_request_count": null,
"star_count": 292,
"watcher_count": null
},
"name": "framework",
"owner": {
"avatar_url": "https://avatars.githubusercontent.com/u/2333448?v=4",
"display_name": null,
"id": "2333448",
"is_verified": null,
"url": "https://github.com/golangers",
"username": "golangers"
},
"owner_type": "organization",
"parent": null,
"platform": "github",
"platform_specific": {
"github": {
"built_by": [],
"is_disabled": false,
"is_discussions_enabled": false,
"is_issues_enabled": true,
"is_mirror": false,
"is_pages_enabled": false,
"is_projects_enabled": true,
"is_pull_requests_enabled": true,
"is_template": false,
"is_wiki_enabled": true,
"language_color": null,
"license_key": "other",
"mirror_url": null,
"network_count": null,
"node_id": "MDEwOlJlcG9zaXRvcnk1NzgzMTk5",
"period_star_count": null,
"source": null
}
},
"programming_language": "Go",
"pushed_at": "2013-01-27T14:54:40Z",
"size_bytes": 673792,
"topics": [],
"unknown_fields": [
"platform_specific.github.built_by"
],
"updated_at": "2026-09-07T09:30:54Z",
"url": "https://github.com/golangers/framework"
}
],
"page": {
"has_more": true,
"next_cursor": "c1.EXAMPLE_CURSOR",
"next_cursor_expires_at": "2026-10-26T12:00:00Z",
"end_reason": null
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "github",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 1000,
"fetched_at": "2026-10-25T12:00:00Z",
"input": null,
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.github.searchRepositories.list({ query: "web framework language:go" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "query=" + encode("web framework language:go");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/github/search_repositories?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"query=" + Uri.EscapeDataString("web framework language:go"));
var res = await http.GetAsync("https://socialtap.dev/v1/github/search_repositories?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/github/search_repositories")
.query(&[("query", "web framework language:go")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/github/search_repositoriesLong arrays and strings are shortened here. Real responses are complete.Docs What you send and what comes back.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field GitHub doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
What to find, as GitHub's repository search reads it: words matched in the name, description, topics and README, a phrase in quotes, and GitHub's qualifiers (language:go, stars:>1000, topic:cli, user:torvalds, org:github, license:mit, archived:false, fork:true, pushed:>2026-01-01).
What comes back
Code repositories with their owner, description, language, topics, license, stars, forks, watchers, open issues and when they were last pushed to.
platformstring- Platform ID (github, …).
idstring- Platform-native repository ID (string): GitHub's number, which stays the same when the repository is renamed or moves to another owner.
full_namestring- Owner and name as in its link (torvalds/linux): what people call it, though it changes when the repository is renamed or transferred.
namestring- The repository's name without its owner (linux), as its link spells it.
urlstring- Canonical repository page URL.
avatar_urlstring- The repository's own icon, apart from its owner's avatar; null when it has none. Platform CDN URLs can expire.
descriptionstring- The repository's short description (GitHub's About), as plain text; null when it has none.
ownerobject- The account that owns it: a person or an organization (owner_type).
Live data from 35 platforms.
What teams build with the GitHub Repository Search API.
Find the most starred projects in a language
Discover repositories created this week
Track open source projects on a topic
Build lists of libraries for research or outreach
Good to know before you build.
- GitHub serves the first thousand results of a search, after which the walk ends with page.end_reason platform_limit: narrow the query with a qualifier, or since and until, to reach the rest.
- Forks are left out unless the query includes fork:true.
- If GitHub's search API refuses, results come from github.com's search page instead, ten a page, without fork counts, license or creation time, and with descriptions cut short.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
| Any source | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the GitHub Repository Search API.
More in the API reference.
How much does the GitHub Repository Search API cost?
How do I get the next page?
Try it with your own search.
Type it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 276 endpoints