{ "openapi": "3.0.1", "info": { "title": "GitHub Repositories Search Scraper", "description": "Search public GitHub repositories by query, language, topics, stars, forks, and activity. Export repo URLs, owners, topics, licenses, timestamps, and optional owner details.", "version": "0.1", "x-build-id": "txiANsMKmlZfKI0AC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~github-repositories-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-github-repositories-search-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/fetch_cat~github-repositories-search-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-github-repositories-search-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/fetch_cat~github-repositories-search-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-github-repositories-search-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search queries", "type": "array", "description": "Required nonempty list of GitHub repository search queries, such as company names, topics, frameworks or keywords. GitHub qualifiers such as stars:>100 and license:mit can be included. Queries run in input order; overlapping repositories are saved only once.", "items": { "type": "string" } }, "language": { "title": "Programming language", "type": "string", "description": "Optional GitHub language filter, for example javascript, python, go, rust, or typescript." }, "topics": { "title": "Topics", "type": "array", "description": "Optional GitHub topics to require. Example: web-scraping, automation, ai.", "items": { "type": "string" } }, "sort": { "title": "Sort repositories by", "enum": [ "best-match", "stars", "forks", "updated" ], "type": "string", "description": "Choose GitHub's ranking for each query: best match, stars, forks or recently updated. Best match uses GitHub's default relevance ranking. Results from multiple queries are not globally re-ranked.", "default": "best-match" }, "maxResults": { "title": "Maximum repositories", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum total repository rows to save across all queries (1–1,000), not per query. The form/schema default is 20; raw input reaching the runtime without this field uses its existing limit of 50. GitHub search exposes at most 1,000 matches per search. Filters or duplicate matches can yield fewer rows. Unresolved rate limits or a deadline reached before required searches finish fail the run while preserving earlier rows.", "default": 20 }, "includeOwnerDetails": { "title": "Include owner details", "type": "boolean", "description": "Fetch optional public owner profile fields. Default: off. Owner lookups require extra GitHub requests; fields can be null or absent for missing public profiles. Unresolved rate limits or transport failures stop the run rather than silently omitting requested enrichment. Without a GitHub token, maxResults must be at most 50 or the run rejects the input before searching.", "default": false }, "order": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Descending requests highest or newest results first for the chosen sort; ascending reverses that order. Default: descending. GitHub controls best-match relevance, so order is not a guarantee of reversing relevance.", "default": "desc" }, "connectionMode": { "title": "Connection", "enum": [ "automatic", "direct" ], "type": "string", "description": "Automatic starts directly. If anonymous GitHub requests are rate limited, it uses existing datacenter proxy recovery (at most 200 proxy requests within the run deadline). No extra Actor fee; infrastructure cost is borne by the creator. Direct disables all proxy fallback. Requests with a GitHub token stay direct because their quota is account-bound." }, "githubToken": { "title": "GitHub token (optional)", "type": "string", "description": "Optional personal access token for higher GitHub API rate limits. Leave empty for small public searches." } } }, "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 } } } } } } } } } }