{
  "openapi": "3.0.1",
  "info": {
    "title": "GitHub Trending MCP Scraper - Star Velocity + AI",
    "description": "Premium tier - scrape GitHub trending repos and developers with cross-run star velocity (accelerating/fading flags). RAG-ready breakout digests, weekly briefings, and tech-radar updates via 5 LLM providers - for VC tech-radar, dev-rel, and AI-tool-watch agents. 99%+ run success. x402-ready.",
    "version": "1.7",
    "x-build-id": "5T23MMiLhXi1ibWbZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/harvestlab~github-trending-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-harvestlab-github-trending-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/harvestlab~github-trending-scraper/runs": {
      "post": {
        "operationId": "runs-sync-harvestlab-github-trending-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/harvestlab~github-trending-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-harvestlab-github-trending-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": {
          "language": {
            "title": "Programming Language",
            "enum": [
              "any",
              "python",
              "javascript",
              "typescript",
              "rust",
              "go",
              "java",
              "c++",
              "c#",
              "ruby",
              "swift",
              "kotlin",
              "php",
              "r",
              "scala",
              "shell"
            ],
            "type": "string",
            "description": "Filter trending repositories by programming language. Choose 'Any Language' to see trending across all languages. Accepts aliases: 'programmingLanguage', 'lang'.",
            "default": "any"
          },
          "programmingLanguage": {
            "title": "Language (CLI alias)",
            "type": "string",
            "description": "CLI alias for 'language'. Hidden from Console form."
          },
          "lang": {
            "title": "Language (CLI alias)",
            "type": "string",
            "description": "CLI alias for 'language'. Hidden from Console form."
          },
          "timeRange": {
            "title": "Time Range",
            "enum": [
              "daily",
              "weekly",
              "monthly"
            ],
            "type": "string",
            "description": "Time range for trending repositories: today, this week, or this month. Accepts alias: 'since'.",
            "default": "daily"
          },
          "since": {
            "title": "Time Range (CLI alias)",
            "type": "string",
            "description": "CLI alias for 'timeRange'. Hidden from Console form."
          },
          "maxRepos": {
            "title": "Max Repositories",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum number of trending repositories to scrape (1-100). GitHub Trending shows roughly 25 per page. Accepts alias: 'maxItems'.",
            "default": 25
          },
          "maxItems": {
            "title": "Max Repos (CLI alias)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "CLI alias for 'maxRepos'. Hidden from Console form."
          },
          "spokenLanguage": {
            "title": "README Spoken Language",
            "enum": [
              "",
              "en",
              "zh",
              "ja",
              "es",
              "fr",
              "de",
              "ko",
              "ru",
              "pt",
              "it",
              "ar"
            ],
            "type": "string",
            "description": "Filter by the spoken/natural language of the README (e.g. 'en' for English, 'zh' for Chinese, 'ja' for Japanese, 'es' for Spanish). Leave empty for all languages. Accepts alias: 'spokenLanguageCode'.",
            "default": ""
          },
          "spokenLanguageCode": {
            "title": "README Spoken Language (CLI alias)",
            "type": "string",
            "description": "CLI alias for 'spokenLanguage'. Hidden from Console form."
          },
          "scrapeDevelopers": {
            "title": "Also Scrape Trending Developers",
            "type": "boolean",
            "description": "Additionally scrape the GitHub Trending Developers page (github.com/trending/developers). Each developer entry includes username, display name, profile URL, avatar, popular repo, and repo description. Items are emitted with type='developer' (repos are type='repository') so you can filter by item type downstream.",
            "default": false
          },
          "includeDevelopers": {
            "title": "Include Developers (CLI alias)",
            "type": "boolean",
            "description": "CLI alias for 'scrapeDevelopers'. Hidden from Console form."
          },
          "enableVelocityTracking": {
            "title": "Track Star Velocity & Momentum Across Runs",
            "type": "boolean",
            "description": "Persist each run's star counts in the default key-value store and emit velocity_score (stars gained since last run), stars_per_hour, and a momentum label ('new', 'accelerating', 'steady', 'fading') on every repo. A 'breakout_summary' item is pushed once per run listing the top-5 breakout repos. Free (no extra charge, no extra HTTP calls). Requires scheduling runs on the same (language, timeRange) filter to build history.",
            "default": true
          },
          "generateWeeklyDigest": {
            "title": "Generate Weekly Breakout Digest",
            "type": "boolean",
            "description": "Emit a single 'weekly_breakout_digest' dataset item summarizing the last N days of trending activity for the selected (language, timeRange) filter. Includes sustained risers, one-hit wonders, dying stars, emerging languages, and breakout-pattern series. When 'enableAiAnalysis' is also on, a VC-analyst narrative (headline, executive summary, investment thesis, action items) is included. Requires at least 2 prior snapshots on the same filter within the window — schedule daily runs for a week before enabling. Charged as 'weekly-digest-generated' at $0.10 per digest.",
            "default": false
          },
          "digestWindowDays": {
            "title": "Digest Window (Days)",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Size of the rolling window used for the weekly digest (1-60 days). Defaults to 7 — a classic 'this week' view. Increase to 14 or 30 for monthly rollups. Only used when 'generateWeeklyDigest' is true.",
            "default": 7
          },
          "enableAiAnalysis": {
            "title": "Enable AI Analysis",
            "type": "boolean",
            "description": "Generate AI-powered trend analysis identifying emerging technologies, hot topics, and investment-worthy projects. Requires an API key for your chosen LLM provider.",
            "default": false
          },
          "llmProvider": {
            "title": "LLM Provider",
            "enum": [
              "openrouter",
              "anthropic",
              "google",
              "openai",
              "ollama"
            ],
            "type": "string",
            "description": "Which LLM provider to use for AI analysis. OpenRouter is the cheapest option.",
            "default": "openrouter"
          },
          "llmModel": {
            "title": "LLM Model",
            "type": "string",
            "description": "Specific model to use. Leave empty for the provider default (google/gemini-2.0-flash-001 for OpenRouter, claude-sonnet-4-20250514 for Anthropic, gemini-2.0-flash for Google AI, gpt-4o-mini for OpenAI, llama3.1 for Ollama)."
          },
          "openrouterApiKey": {
            "title": "OpenRouter API Key",
            "type": "string",
            "description": "Your OpenRouter API key. Get one free at openrouter.ai/keys. Required if using OpenRouter as the LLM provider."
          },
          "anthropicApiKey": {
            "title": "Anthropic API Key",
            "type": "string",
            "description": "Your Anthropic API key. Get one at console.anthropic.com. Required if using Anthropic as the LLM provider."
          },
          "googleApiKey": {
            "title": "Google AI API Key",
            "type": "string",
            "description": "API key for Google AI (Gemini). Get one at aistudio.google.com/app/apikey. Required if using Google provider."
          },
          "openaiApiKey": {
            "title": "OpenAI API Key",
            "type": "string",
            "description": "API key from platform.openai.com. Required if using OpenAI provider."
          },
          "ollamaBaseUrl": {
            "title": "Ollama Base URL",
            "type": "string",
            "description": "Base URL for Ollama API (self-hosted). Default: http://localhost:11434."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings. Recommended for reliable results when scraping at higher volume."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}