{
  "openapi": "3.0.1",
  "info": {
    "title": "GitHub New Repo, Star-Jump & Release Alerts (API)",
    "description": "Finds new and fast-rising GitHub repositories by topic, language and stars, and alerts on new releases of repos you watch. Official GitHub REST API, no scraping. Only new repos, releases and star jumps on scheduled runs. Optional token.",
    "version": "0.1",
    "x-build-id": "465MAut07Q5f96bbG"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fedsignals~github-repo-release-tracker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fedsignals-github-repo-release-tracker",
        "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/fedsignals~github-repo-release-tracker/runs": {
      "post": {
        "operationId": "runs-sync-fedsignals-github-repo-release-tracker",
        "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/fedsignals~github-repo-release-tracker/run-sync": {
      "post": {
        "operationId": "run-sync-fedsignals-github-repo-release-tracker",
        "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": {
          "topics": {
            "title": "Topics",
            "type": "array",
            "description": "Returns repositories tagged with any of these GitHub topics, e.g. llm, mcp, ai-agents, rag. Each topic is one search. Empty = all topics (filtered only by stars, age and language).",
            "default": [
              "mcp"
            ],
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Returns only repositories whose main language is one of these GitHub language names, e.g. Python, TypeScript, Go, Rust. Empty = any language. A misspelled name fails the run before any row is charged, with a suggestion.",
            "items": {
              "type": "string"
            }
          },
          "minStars": {
            "title": "Minimum stars",
            "minimum": 0,
            "type": "integer",
            "description": "Returns only repositories with at least this many stars. Raise it (e.g. 200) to see only breakout projects.",
            "default": 50
          },
          "createdWithinDays": {
            "title": "Created within the last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Returns only repositories created in the last N days (1–365). Use 7–30 to find new projects.",
            "default": 30
          },
          "watchRepos": {
            "title": "Watch repositories for new releases",
            "type": "array",
            "description": "Returns new releases of these repositories, as owner/name (e.g. langchain-ai/langchain) or a github.com URL. With 'Only new' on, each run returns only releases published since the previous run; the first run returns the current latest release. Up to 200 repositories.",
            "items": {
              "type": "string"
            }
          },
          "onlyNew": {
            "title": "Only new (incremental)",
            "type": "boolean",
            "description": "On: returns (and charges for) only repositories and releases not delivered by an earlier run with the same filters, plus star jumps. Turn on for scheduled runs. Off: returns everything that matches, every run.",
            "default": true
          },
          "starJumpThreshold": {
            "title": "Star jump alert (stars gained since last run)",
            "minimum": 0,
            "type": "integer",
            "description": "In incremental mode, a repository you already received comes back as a 'star_jump' row when it gained at least this many stars since the previous run. 0 = off.",
            "default": 100
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum rows returned (and charged) per run, across new repos, releases and star jumps.",
            "default": 100
          },
          "githubToken": {
            "title": "GitHub token (optional)",
            "type": "string",
            "description": "Optional. Your own GitHub personal access token (a fine-grained token with no extra permissions is enough; it only reads public data). Raises GitHub's limits from 10 to 30 searches a minute and from 60 to 5,000 other requests an hour. It is stored encrypted by Apify and never logged."
          },
          "discoverRepos": {
            "title": "Discover new repositories",
            "type": "boolean",
            "description": "Turn off to only track releases of 'watchRepos'.",
            "default": true
          },
          "fetchLatestRelease": {
            "title": "Add latest release to discovered repos",
            "type": "boolean",
            "description": "Looks up each discovered repository's latest release (one extra API request each). Without a token GitHub allows 60 such requests an hour per IP; when they run out, latestRelease is left empty and the run says so.",
            "default": true
          },
          "releasesPerRepo": {
            "title": "Releases per watched repo (first run / non-incremental)",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many recent releases to return per watched repository on the first run, or on every run when 'Only new' is off.",
            "default": 1
          },
          "includePrereleases": {
            "title": "Include pre-releases",
            "type": "boolean",
            "description": "Also return releases marked as pre-release (alpha, beta, rc).",
            "default": false
          },
          "includeForks": {
            "title": "Include forks",
            "type": "boolean",
            "description": "Also return forked repositories in discovery.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Optional. Separate incremental memory per saved task. Defaults to a hash of your filters."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}