DEVELOPER TOOLS

Search GitHub Issues API

Search issues and pull requests across all of GitHub with GitHub's search syntax. Returns parsed rows (author, repo, labels, comment count, reactions) plus the rate-limit headers so you can pace yourself. Works without a token (10 searches/min per IP); pass your own token for 30/min.

githubsearchissuesdeveloperpython
Try it freeGet an API key

How to call it

Send one POST to api.upapi.io/github-search-issues.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 6 weighted units of your monthly quota. The operation times out after 30 seconds. Identical requests are served from cache for 120 seconds, unbilled.

endpoint
POST https://api.upapi.io/github-search-issues.get

Search GitHub Issues API reference

Request parameters

q
stringrequired — GitHub search syntax, e.g. 'is:issue is:open "note taking app" language:python'
page
integer — Page number (search caps at 1000 rows)
sort
string — comments | reactions | created | updated | interactions (default: best match)
order
string — asc | desc
token
string — Optional GitHub token: raises the limit from 10 to 30 searches/min and lets the search see private repos the token can read
perPage
integer — Rows per page (max 100)
proxyUrl
string — Optional exit to send from; a datacenter exit is leased when omitted
includePullRequests
boolean — GitHub returns PRs on this endpoint too; false filters them out client-side

Response fields

items
arrayrequired
items[].id
integerrequired
items[].body
stringrequired
items[].state
stringrequired
items[].title
stringrequired
items[].author
stringrequired
items[].labels
arrayrequired
items[].number
integerrequired
items[].htmlUrl
stringrequired
items[].closedAt
stringrequired
items[].comments
integerrequired
items[].createdAt
stringrequired
items[].reactions
integerrequired
items[].updatedAt
stringrequired
items[].authorType
stringrequired
items[].repository
stringrequired — owner/repo the issue belongs to
items[].isPullRequest
booleanrequired — GitHub lists pull requests on the issues endpoints; this tells them apart
items[].authorAssociation
stringrequired
fetchedAt
stringrequired
rateLimit
objectrequired — The rate-limit headers GitHub returned on THIS response, surfaced so the caller can pace itself instead of the operation sleeping on its behalf.
rateLimit.limit
integerrequired — X-RateLimit-Limit: requests allowed per window
rateLimit.resetAt
stringrequired — X-RateLimit-Reset as an ISO-8601 UTC timestamp
rateLimit.resource
stringrequired — X-RateLimit-Resource: which bucket (core, search, graphql, ...)
rateLimit.remaining
integerrequired — X-RateLimit-Remaining: requests left
rateLimit.resetEpoch
integerrequired — X-RateLimit-Reset as unix seconds
totalCount
integerrequired
incompleteResults
booleanrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body
{
  "q": "is:issue is:open \"note taking app\" language:python",
  "page": 1,
  "perPage": 30,
  "includePullRequests": true
}
json — example response shape
{
  "items": [
    {
      "id": 1,
      "body": "example",
      "state": "example",
      "title": "Alan Turing",
      "author": "example",
      "labels": [
        "example"
      ],
      "number": 1,
      "htmlUrl": "example",
      "closedAt": "example",
      "comments": 1,
      "createdAt": "example",
      "reactions": 1,
      "updatedAt": "example",
      "authorType": "example",
      "repository": "example",
      "isPullRequest": false,
      "authorAssociation": "example"
    }
  ],
  "fetchedAt": "example",
  "rateLimit": {
    "limit": 5,
    "resetAt": "example",
    "resource": "example",
    "remaining": 1,
    "resetEpoch": 1
  },
  "totalCount": 1,
  "incompleteResults": false
}

Code snippets

cURL
curl
curl -X POST https://api.upapi.io/github-search-issues.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "q": "is:issue is:open \"note taking app\" language:python", "page": 1, "perPage": 30, "includePullRequests": true }'
JavaScript
javascript
const response = await fetch('https://api.upapi.io/github-search-issues.get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "q": "is:issue is:open \"note taking app\" language:python",
  "page": 1,
  "perPage": 30,
  "includePullRequests": true
}),
});

const data = await response.json();
console.log(data);
Python
python
import requests

response = requests.post(
    'https://api.upapi.io/github-search-issues.get',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "q": "is:issue is:open \"note taking app\" language:python",
  "page": 1,
  "perPage": 30,
  "includePullRequests": True
},
)

print(response.json())
Go
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "q": "is:issue is:open \"note taking app\" language:python", "page": 1, "perPage": 30, "includePullRequests": true }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/github-search-issues.get", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}
PHP
php
<?php

$payload = json_encode([
    'q' => 'is:issue is:open "note taking app" language:python',
    'page' => 1,
    'perPage' => 30,
    'includePullRequests' => true,
]);

$ch = curl_init('https://api.upapi.io/github-search-issues.get');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);
Ruby
ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/github-search-issues.get')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "q": "is:issue is:open \"note taking app\" language:python", "page": 1, "perPage": 30, "includePullRequests": true }.to_json

response = http.request(request)
puts JSON.parse(response.body)
Java
java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"q\": \"is:issue is:open \\\"note taking app\\\" language:python\", \"page\": 1, \"perPage\": 30, \"includePullRequests\": true }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/github-search-issues.get")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}
C#
csharp
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"q\": \"is:issue is:open \\\"note taking app\\\" language:python\", \"page\": 1, \"perPage\": 30, \"includePullRequests\": true }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/github-search-issues.get", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Search GitHub Issues API cost per call?

Each call spends 6 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Search GitHub Issues API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Search GitHub Issues API responses cached?

Yes — identical requests are served from cache for 120 seconds, and a cache hit is not billed.

More Developer Tools APIs

Browse every Developer Tools API →