{
"openapi": "3.0.1",
"info": {
"title": "GitHub Repos & Trending Scraper – Stars, Issues & Releases",
"description": "Scrape GitHub repositories, search results, GitHub trending repos and developers, issues, pull requests and releases: stars, forks, watchers, topics, license, languages, latest release, last commit, contributors count. Official API + github.com/trending, optional token.",
"version": "1.0",
"x-build-id": "XQpQ6xNfU6iC2VUuk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~github-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-github-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/openharvest~github-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-github-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/openharvest~github-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-github-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"title": "What to scrape",
"enum": [
"trending",
"searchRepositories",
"repoDetails",
"issues",
"releases"
],
"type": "string",
"description": "trending – github.com/trending repositories or developers (no API limits).
searchRepositories – GitHub repository search by keyword, language and stars.
repoDetails – full stats for a list of repositories.
issues – issues and/or pull requests of repositories.
releases – releases with download counts.",
"default": "trending"
},
"searchQuery": {
"title": "Search query",
"type": "string",
"description": "Used by searchRepositories. Keywords plus any GitHub search qualifiers, e.g. web scraping, topic:llm, org:apify, pushed:>2026-01-01."
},
"repositories": {
"title": "Repositories",
"type": "array",
"description": "Used by repoDetails, issues and releases. Accepted formats: owner/repo, https://github.com/owner/repo, git@github.com:owner/repo.git.",
"items": {
"type": "string"
}
},
"language": {
"title": "Programming language",
"type": "string",
"description": "Optional. Filters trending and searchRepositories by language, e.g. python, typescript, c++, jupyter notebook. Leave empty for all languages."
},
"maxItems": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Maximum number of results (rows) for the whole run. Set to 0 for no limit. You pay per result, so this also caps your cost.",
"default": 50
},
"trendingType": {
"title": "Trending: repositories or developers",
"enum": [
"repositories",
"developers"
],
"type": "string",
"description": "Used by trending. Developers rows contain only the public login, profile URL and their popular repository.",
"default": "repositories"
},
"trendingPeriod": {
"title": "Trending period",
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string",
"description": "Used by trending: today, this week or this month.",
"default": "daily"
},
"spokenLanguage": {
"title": "Spoken language (trending repositories)",
"type": "string",
"description": "Optional ISO 639-1 code of the README language, e.g. en, zh, es. Used by trending repositories only."
},
"sort": {
"title": "Search: sort by",
"enum": [
"best-match",
"stars",
"forks",
"updated",
"help-wanted-issues"
],
"type": "string",
"description": "Used by searchRepositories.",
"default": "best-match"
},
"minStars": {
"title": "Search: minimum stars",
"minimum": 0,
"type": "integer",
"description": "Used by searchRepositories: only repositories with at least this many stars. 0 = no filter.",
"default": 0
},
"detailLevel": {
"title": "Repository details level",
"enum": [
"basic",
"standard",
"full"
],
"type": "string",
"description": "Used by repoDetails. basic = 1 API request per repo (stars, forks, watchers, topics, license...). standard = 5 requests (+ languages breakdown, latest release, last commit date, contributors count). full = 6 requests (+ README excerpt).",
"default": "standard"
},
"issueType": {
"title": "Issues: type",
"enum": [
"both",
"issues",
"pulls"
],
"type": "string",
"description": "Used by issues.",
"default": "both"
},
"issueState": {
"title": "Issues: state",
"enum": [
"open",
"closed",
"all"
],
"type": "string",
"description": "Used by issues.",
"default": "open"
},
"labels": {
"title": "Issues: labels",
"type": "array",
"description": "Optional. Only issues/PRs that have ALL of these labels, e.g. bug, good first issue.",
"items": {
"type": "string"
}
},
"since": {
"title": "Issues: updated since",
"type": "string",
"description": "Optional. Only issues/PRs updated at or after this date. Absolute (YYYY-MM-DD) or relative (7 days, 1 month)."
},
"includePrereleases": {
"title": "Releases: include pre-releases",
"type": "boolean",
"description": "Used by releases.",
"default": true
},
"maxItemsPerRepository": {
"title": "Max issues/releases per repository",
"minimum": 0,
"type": "integer",
"description": "Used by issues and releases: cap per repository (newest first). 0 = no limit.",
"default": 30
},
"githubToken": {
"title": "GitHub token (optional)",
"type": "string",
"description": "Optional GitHub personal access token. Without it the GitHub API allows only 60 requests/hour (search: 10/minute) per IP, shared with other users. With a token: 5,000 requests/hour (search: 30/minute). A fine-grained token with no permissions (public repositories, read-only) is enough – create one at github.com/settings/personal-access-tokens. Stored encrypted. Not needed for trending."
},
"maxWaitForRateLimitSecs": {
"title": "Max wait for rate limit (seconds)",
"minimum": 0,
"maximum": 3700,
"type": "integer",
"description": "If GitHub's rate limit is reached and it resets within this many seconds, the Actor waits and continues. Otherwise it stops cleanly, keeps the results and adds a free RATE_LIMITED status row.",
"default": 90
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}