API reference
GitHub Repository Issues API
List a repository's issues (pull requests included, flagged per item).
Endpoint
GET/v1/github/repo/issueslive · proven1 creditParameters
Query parameters
Useful optional inputs
sort— Choose the documented source ordering before paging through results.Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
limit— Bound the returned rows to what your task needs.A smaller limit does not necessarily reduce source calls or price; inspect the quote.
dry_run— Read a free estimate before fetching sources or scheduling paid work.Zero credits; cache status and availability are snapshots rather than guarantees.
| Name | Required | Description | Example |
|---|---|---|---|
url | yes | Repository URL | https://github.com/vercel/next.js |
state | no | Issue state: open, closed or all (default open) Accepted values: open, closed, all. Case, spaces, hyphens and underscores are interchangeable. | open |
labels | no | Comma-separated label names to filter by | bug |
type | no | Client-side filter: issue or pr (GitHub's feed mixes both) Accepted values: issue, issues, pr, prs, pull, pulls, pull_request. Case, spaces, hyphens and underscores are interchangeable. | issue |
sort | no | Sort key: created, updated or comments Accepted values: created, updated, comments. Case, spaces, hyphens and underscores are interchangeable. | created |
direction | no | Sort direction: asc or desc Accepted values: asc, desc. Case, spaces, hyphens and underscores are interchangeable. | desc |
since | no | Only items updated at or after this ISO-8601 timestamp | 2026-01-01T00:00:00Z |
limit | no | Items per page, max 100 | 25 |
cursor | no | Opaque page cursor from a previous response | 2 |
dry_run | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. | 1 |
Examples
Make the request
curl "https://www.monocrawl.com/v1/github/repo/issues?url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js" \ -H "x-api-key: mn_your_key_here"
TypeScript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
"https://www.monocrawl.com/v1/github/repo/issues?url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js",
{ headers: { "x-api-key": key } },
);
const body = await res.json();
if (!body.success) {
// one error shape for every endpoint — see /docs/errors
throw new Error(`${body.error.type}: ${body.error.message}`);
}
console.log(body.data, "credits left:", body.credits_remaining);Python
import os
import requests
res = requests.get(
"https://www.monocrawl.com/v1/github/repo/issues?url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js",
headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
timeout=60,
)
body = res.json()
if not body["success"]:
# one error shape for every endpoint — see /docs/errors
raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")
print(body["data"], "credits left:", body["credits_remaining"])Response
Response fields and example
This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.
{
"success": true,
"platform": "github",
"endpoint": "/v1/github/repo/issues",
"data": {
"items": [
{
"id": 44,
"number": 7,
"title": "Example issue",
"is_pull_request": false
}
],
"cursor": null,
"has_more": null
},
"credits_used": 1,
"credits_remaining": 99,
"request_id": "req_…",
"cached": false
}The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.
Schema basis: reviewed response shaper. See schema coverage and validation limits.
Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.
| Field inside data | Type | Meaning |
|---|---|---|
items | array | Records in this response page. |
items[].id | number | string | null | Source ID. Preserve its original representation; do not coerce a large string ID to a JavaScript number. |
items[].number | number | null | Issue number within this repository. |
items[].title | string | null | Issue title. |
items[].body | string | null | Issue text; bundle previews may be shortened. |
items[].url | string | null | Original source URL when supplied. |
items[].state | string | null | Source issue state. |
items[].is_pull_request | boolean | null | Whether the source item is a pull request. |
items[].author | string | null | Author login. |
items[].comments | number | null | Comments reported by the source; null or absent is unknown, not zero. |
items[].created_at | string | null | Source publication time, normalized to an ISO date-time when available. |
items[].updated_at | string | null | Source publication time, normalized to an ISO date-time when available. |
count | number | null | Returned row count when supplied; not the full source total. |
cursor | string | null | Opaque next-page token. A missing token does not prove full history was retrieved. |
has_more | boolean | null | Source continuation indicator; null means unknown. |
_warnings | array | Collection limitations or component warnings. Read before interpreting coverage. |
The source feed includes pull requests. The type filter can be applied to an already fetched page.
Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference