{
  "openapi": "3.0.1",
  "info": {
    "title": "GitHub Scraper - Repos, Users, Orgs, Trending & Search",
    "description": "Scrape GitHub repositories, developer and organisation profiles from search, links, logins and trending: stars, forks, language shares, topics, license, contributors, used-by, followers, socials and the email shown on the profile. Monitor mode, no token. $0.45 per 1,000 rows.",
    "version": "0.1",
    "x-build-id": "KsxnT8Z905C0ATUDd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~github-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-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/topapi~github-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-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/topapi~github-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-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": {
          "searchQueries": {
            "title": "🔎 Search",
            "type": "array",
            "description": "Searches, one per line, in GitHub's own search syntax, e.g. \"web scraping\", \"llm agent language:python stars:>500\", \"location:berlin followers:>100\" (with Search for: Users). Each line is its own search.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "🧭 Search for",
            "enum": [
              "repositories",
              "users"
            ],
            "type": "string",
            "description": "What the searches above look for: repositories, or users and organisations (people rows with their full profile).",
            "default": "repositories"
          },
          "startUrls": {
            "title": "🔗 GitHub links",
            "type": "array",
            "description": "Any GitHub link: a repository, a user or organisation profile, a search page (github.com/search?q=..&type=repositories), a trending page, a topic (github.com/topics/cli), an organisation's people page, a user's followers tab or a repository's contributors graph.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "repositories": {
            "title": "📦 Repositories",
            "type": "array",
            "description": "Repositories as owner/repo or links, one per line, e.g. \"apify/crawlee\", \"https://github.com/facebook/react\". Each comes back as one repository row.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "👤 Users and organisations",
            "type": "array",
            "description": "GitHub logins or profile links, one per line, e.g. \"torvalds\", \"https://github.com/apify\". A person comes back as a user row, an organisation as an organisation row.",
            "items": {
              "type": "string"
            }
          },
          "trending": {
            "title": "🔥 Trending",
            "type": "boolean",
            "description": "Also read GitHub's trending page (github.com/trending): up to 25 repositories or developers per language and period, with their rank and stars gained.",
            "default": false
          },
          "trendingType": {
            "title": "🔥 Trending list",
            "enum": [
              "repositories",
              "developers"
            ],
            "type": "string",
            "description": "Trending repositories or trending developers (developer rows are full user profiles with their popular repository).",
            "default": "repositories"
          },
          "trendingLanguages": {
            "title": "🔥 Trending languages",
            "type": "array",
            "description": "Programming languages for the trending lists, one per line, as GitHub names them, e.g. \"python\", \"rust\", \"c++\". Empty = all languages.",
            "items": {
              "type": "string"
            }
          },
          "trendingSince": {
            "title": "🔥 Trending period",
            "enum": [
              "daily",
              "weekly",
              "monthly"
            ],
            "type": "string",
            "description": "Trending today, this week or this month.",
            "default": "daily"
          },
          "spokenLanguageCode": {
            "title": "🔥 Spoken language",
            "type": "string",
            "description": "Trending repositories whose README is in this spoken language, as a two-letter code, e.g. \"en\", \"zh\", \"es\". Empty = any."
          },
          "language": {
            "title": "💻 Programming language",
            "type": "string",
            "description": "Only repositories in this language, or users who write it, e.g. \"python\", \"typescript\", \"go\". Added to every search as language:."
          },
          "topics": {
            "title": "🏷️ Topics",
            "type": "array",
            "description": "Only repositories tagged with every one of these topics, e.g. \"cli\", \"llm\". Added as topic:.",
            "items": {
              "type": "string"
            }
          },
          "minStars": {
            "title": "⭐ Minimum stars",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Only repositories with at least this many stars (stars:>=). Also applied to repositories from links, trending and owner lists."
          },
          "maxStars": {
            "title": "⭐ Maximum stars",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Only repositories with at most this many stars, e.g. 500 to find young projects. Empty = no limit."
          },
          "minForks": {
            "title": "🍴 Minimum forks",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Only repositories with at least this many forks (forks:>=)."
          },
          "license": {
            "title": "📜 License",
            "enum": [
              "any",
              "mit",
              "apache-2.0",
              "gpl-3.0",
              "gpl-2.0",
              "agpl-3.0",
              "lgpl-3.0",
              "bsd-3-clause",
              "bsd-2-clause",
              "mpl-2.0",
              "unlicense",
              "isc",
              "cc0-1.0"
            ],
            "type": "string",
            "description": "Only repositories under this license.",
            "default": "any"
          },
          "createdAfter": {
            "title": "📅 Created after",
            "type": "string",
            "description": "Only repositories (or accounts) created on or after this date, e.g. 2026-01-01, or a relative window such as \"30 days\"."
          },
          "createdBefore": {
            "title": "📅 Created before",
            "type": "string",
            "description": "Only repositories (or accounts) created on or before this date."
          },
          "pushedAfter": {
            "title": "📅 Pushed after",
            "type": "string",
            "description": "Only repositories with a push on or after this date (actively maintained), e.g. 2026-06-01 or \"90 days\"."
          },
          "owner": {
            "title": "🏢 Owner",
            "type": "string",
            "description": "Only repositories owned by this user or organisation login, e.g. \"microsoft\" (user:)."
          },
          "includeForks": {
            "title": "🍴 Include forks",
            "type": "boolean",
            "description": "GitHub's search leaves forks out; turn on to include them (fork:true).",
            "default": false
          },
          "excludeArchived": {
            "title": "🗄️ Exclude archived",
            "type": "boolean",
            "description": "Leave out archived (read-only) repositories.",
            "default": false
          },
          "location": {
            "title": "📍 User location",
            "type": "string",
            "description": "User searches: only accounts whose profile location matches, e.g. \"Berlin\", \"San Francisco\" (location:)."
          },
          "minFollowers": {
            "title": "👥 Minimum followers",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Only users with at least this many followers (followers:>= on user searches; also applied to people from lists)."
          },
          "minRepos": {
            "title": "📚 Minimum public repositories",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Only users with at least this many public repositories (repos:>=)."
          },
          "accountType": {
            "title": "👤 Account type",
            "enum": [
              "",
              "user",
              "org"
            ],
            "type": "string",
            "description": "User searches: people, organisations or both.",
            "default": ""
          },
          "sort": {
            "title": "↕️ Sort",
            "enum": [
              "best-match",
              "stars",
              "forks",
              "updated",
              "help-wanted-issues",
              "followers",
              "repositories",
              "joined"
            ],
            "type": "string",
            "description": "GitHub's order for searches. Stars, forks, updated and help-wanted issues sort repositories; followers, repositories and joined sort users.",
            "default": "best-match"
          },
          "order": {
            "title": "↕️ Order",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Highest / newest first, or the reverse.",
            "default": "desc"
          },
          "splitLargeSearches": {
            "title": "🧩 Go past 1,000 results",
            "type": "boolean",
            "description": "GitHub returns at most 1,000 results per search. When a search matches more and Max results asks for more, it is split by creation date so each part stays under the cap.",
            "default": true
          },
          "withEmailOnly": {
            "title": "📧 With email only",
            "type": "boolean",
            "description": "Keep only users and organisations that show an email on their public profile (bio, profile README or the organisation's email). Others are not delivered or charged.",
            "default": false
          },
          "withWebsiteOnly": {
            "title": "🌐 With website only",
            "type": "boolean",
            "description": "Keep only users and organisations with a website on their profile.",
            "default": false
          },
          "hireableOnly": {
            "title": "💼 Available for hire only",
            "type": "boolean",
            "description": "Keep only users who mark themselves available for hire (needs Join date and REST fields on; GitHub answers 60 of those lookups an hour per IP).",
            "default": false
          },
          "minLeadScore": {
            "title": "🎯 Minimum lead score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only users whose lead score (0-100: followers, stars, repositories, email, LinkedIn, website, company) is at least this, e.g. 40."
          },
          "excludeForks": {
            "title": "🍴 Drop forks",
            "type": "boolean",
            "description": "Drop forked repositories from links, trending and owner lists too.",
            "default": false
          },
          "filterTopics": {
            "title": "🏷️ Keep topics",
            "type": "array",
            "description": "Keep only repositories with at least one of these topics, e.g. \"llm\", \"rag\" (applied after GitHub's answer, so it works on trending and owner lists).",
            "items": {
              "type": "string"
            }
          },
          "aiOnly": {
            "title": "🤖 AI repositories only",
            "type": "boolean",
            "description": "Keep only repositories about AI (topics or description mention AI, LLMs, agents, RAG, machine learning and the like). Every row carries isAiRelated either way.",
            "default": false
          },
          "includeDetails": {
            "title": "📊 Repository details",
            "type": "boolean",
            "description": "Language shares, contributor count and top contributors, latest release and used-by count (one small request per repository, included in the price).",
            "default": true
          },
          "includeReadme": {
            "title": "📄 README and page stats",
            "type": "boolean",
            "description": "Reads each repository's page: README as plain text (up to 20,000 characters), commit count, open issues and pull requests apart, watchers, releases and tags. On user and organisation rows: the profile README.",
            "default": false
          },
          "includeOwnerDetails": {
            "title": "🏢 Owner details",
            "type": "boolean",
            "description": "On repository rows, the owner's name, company, website, location, email, bio, X handle, followers and public repositories (one profile read per owner).",
            "default": false
          },
          "includeRestFields": {
            "title": "🗓️ Join date and REST fields",
            "type": "boolean",
            "description": "Join date, last update, gists, hireable and exact follower counts from GitHub's REST API. Without a token GitHub answers 60 of these an hour per IP, so large runs fill them for the first ~55 people.",
            "default": true
          },
          "includeContributions": {
            "title": "📈 Contributions",
            "type": "boolean",
            "description": "Each user's public contributions in the last year (one request per user).",
            "default": false
          },
          "includeRepoStats": {
            "title": "⭐ Repository stats",
            "type": "boolean",
            "description": "totalStars, totalForks and topLanguages over each user's or organisation's own top 60 repositories (two requests per person).",
            "default": false
          },
          "includeStarred": {
            "title": "🌟 Starred repositories",
            "type": "boolean",
            "description": "The 30 repositories each user starred most recently (interests and tech stack).",
            "default": false
          },
          "includeLeadScore": {
            "title": "🎯 Lead score",
            "type": "boolean",
            "description": "leadScore 0-100, leadTier (cold / warm / hot / scorching), leadReasons and bestContact on user rows.",
            "default": true
          },
          "verifyEmail": {
            "title": "✉️ Check email domain",
            "type": "boolean",
            "description": "emailDomainHasMx: whether the email's domain has mail servers (a DNS check, not a mailbox test).",
            "default": false
          },
          "includeRepositories": {
            "title": "📦 Owners' repositories",
            "type": "boolean",
            "description": "For every user or organisation delivered, also deliver its repositories (most-starred first, up to the number below), each charged as a repository row.",
            "default": false
          },
          "maxRepositoriesPerOwner": {
            "title": "📦 Repositories per owner",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Repositories delivered per owner when the option above is on.",
            "default": 30
          },
          "includeMembers": {
            "title": "🏢 Organisation members",
            "type": "boolean",
            "description": "For every organisation delivered, also deliver its public members as user rows.",
            "default": false
          },
          "includeFollowers": {
            "title": "👥 Followers",
            "type": "boolean",
            "description": "For every user delivered, also deliver their followers as user rows.",
            "default": false
          },
          "includeFollowing": {
            "title": "👥 Following",
            "type": "boolean",
            "description": "For every user delivered, also deliver the accounts they follow as user rows.",
            "default": false
          },
          "maxPeoplePerSource": {
            "title": "👥 People per list",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Members, followers or following delivered per account.",
            "default": 50
          },
          "includeContributors": {
            "title": "🧑‍💻 Contributors",
            "type": "boolean",
            "description": "For every repository delivered, also deliver its top contributors as user rows (bots left out).",
            "default": false
          },
          "maxContributorsPerRepo": {
            "title": "🧑‍💻 Contributors per repository",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Top contributors delivered per repository.",
            "default": 10
          },
          "monitorMode": {
            "title": "🔁 Monitor mode",
            "type": "boolean",
            "description": "Deliver only repositories and accounts not delivered by an earlier monitor run of the same store. Pairs with a daily schedule.",
            "default": false
          },
          "monitorChanges": {
            "title": "📈 Also changed rows",
            "type": "boolean",
            "description": "In monitor mode, also deliver known repositories whose stars or forks moved (and accounts whose followers or repositories moved), with starsChange, forksChange or followersChange.",
            "default": false
          },
          "monitorStoreName": {
            "title": "🗃️ Monitor store",
            "type": "string",
            "description": "Name of the key-value store that remembers what was delivered. Use one name per watch list.",
            "default": "github-monitor"
          },
          "resetMonitor": {
            "title": "♻️ Reset monitor",
            "type": "boolean",
            "description": "Forget what the store remembers and start over.",
            "default": false
          },
          "maxResults": {
            "title": "🔢 Max results per input",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Rows per search, trending list, owner list or people list. GitHub serves 1,000 per search (more with Go past 1,000 results) and 25 per trending list. 0 = no limit.",
            "default": 100
          },
          "maxItems": {
            "title": "🔢 Max rows in total",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many rows across all inputs (all row types). 0 = no limit."
          },
          "compact": {
            "title": "🗜️ Compact rows",
            "type": "boolean",
            "description": "Core fields only (name, link, stars, language, contact fields...) - trimmed for spreadsheets, AI agents and MCP.",
            "default": false
          },
          "dedupe": {
            "title": "🧹 One row per record",
            "type": "boolean",
            "description": "A repository or account found by several inputs is delivered (and charged) once. Turn off to get one row per input.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy",
            "type": "object",
            "description": "Default: the platform's own connection first, then an Apify datacenter session, then residential if GitHub keeps refusing. Set your own proxy only if you need a specific exit.",
            "default": {
              "useApifyProxy": true
            }
          },
          "maxConcurrency": {
            "title": "⚡ Parallel requests",
            "minimum": 1,
            "maximum": 24,
            "type": "integer",
            "description": "Requests in flight at once (GitHub's search is always one at a time).",
            "default": 8
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}