{
  "openapi": "3.0.1",
  "info": {
    "title": "Rumble Scraper - Videos, Channels, Playlists & Transcripts",
    "description": "Scrape Rumble: every video of a channel, user, playlist, category or trending list with exact views, rumbles, comments, duration, tags and MP4 links; channel rows with followers, socials and e-mail; transcripts; keywords; monitor mode. $0.90 per 1,000 videos.",
    "version": "0.1",
    "x-build-id": "IbXq691uVTawV98Kw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~rumble-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-rumble-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~rumble-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-rumble-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~rumble-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-rumble-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": {
          "startUrls": {
            "title": "Rumble links",
            "type": "array",
            "description": "Any Rumble link: channels (<code>https://rumble.com/c/bongino</code>), users (<code>https://rumble.com/user/RealAmericasVoice</code>), channel tabs (<code>/c/NewsmaxTV/shorts</code>, <code>/livestreams</code>, <code>/playlists</code>, <code>/about</code>), playlists (<code>https://rumble.com/playlists/bIiAjWZmvAg</code>), videos, Shorts and embed links, categories (<code>https://rumble.com/category/news</code>), trending (<code>https://rumble.com/videos?sort=views&amp;date=today</code>), <code>/editor-picks</code>, <code>/browse/live</code> and search links (read as keywords). Mix them freely.",
            "items": {
              "type": "string"
            }
          },
          "channels": {
            "title": "Channel or user names",
            "type": "array",
            "description": "Channel or user names as they appear in the link (<code>bongino</code>, <code>TimcastIRL</code>, <code>RealAmericasVoice</code>); the channel page is tried first, then the user page.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords such as <code>bitcoin</code> or <code>election night</code>. Rumble's own search page answers automated visitors with a human check, so keyword results come from DuckDuckGo's index of rumble.com (typically 10-40 videos per keyword) and every video is then read from Rumble itself.",
            "items": {
              "type": "string"
            }
          },
          "channelSearchQueries": {
            "title": "Search channels by keyword",
            "type": "array",
            "description": "Keywords to find Rumble channels (one channel row each), through DuckDuckGo's index of rumble.com.",
            "items": {
              "type": "string"
            }
          },
          "videoIds": {
            "title": "Video ids",
            "type": "array",
            "description": "Rumble video ids from the link (<code>v7ht1li</code>) or embed ids (<code>v7fmoo0</code>).",
            "items": {
              "type": "string"
            }
          },
          "contentTypes": {
            "title": "Channel content",
            "type": "array",
            "description": "Which tabs of each channel or user link to read: <b>all</b> (the channel's main page: every upload, livestream and Short - the whole catalogue), <b>videos</b> (uploads only; Rumble lists at most 30 pages = 750 of them), <b>shorts</b>, <b>livestreams</b>, <b>playlists</b> (one row per playlist).",
            "items": {
              "type": "string",
              "enum": [
                "all",
                "videos",
                "shorts",
                "livestreams",
                "playlists"
              ],
              "enumTitles": [
                "All (whole catalogue)",
                "Videos (uploads)",
                "Shorts",
                "Livestreams",
                "Playlists"
              ]
            },
            "default": [
              "all"
            ]
          },
          "includeChannelInfo": {
            "title": "Channel row",
            "type": "boolean",
            "description": "One row per channel or user link: followers, total views, video count, join date, description, social links, public e-mail, avatar, banner, upload cadence (latest upload, uploads in the last 30 days, average views of the latest videos).",
            "default": true
          },
          "includeChannelVideos": {
            "title": "Channel videos",
            "type": "boolean",
            "description": "The videos of each channel or user link (the tabs chosen above). Off: channel rows only.",
            "default": true
          },
          "includeChannelPlaylists": {
            "title": "Channel playlists",
            "type": "boolean",
            "description": "One row per public playlist of each channel link (title, video count, last update).",
            "default": false
          },
          "includePlaylistVideos": {
            "title": "Playlist videos",
            "type": "boolean",
            "description": "For playlist links: every video in the playlist.",
            "default": true
          },
          "includePlaylistInfo": {
            "title": "Playlist row",
            "type": "boolean",
            "description": "For playlist links: one row with the playlist's title, description, video count, owner and last update.",
            "default": true
          },
          "channelSort": {
            "title": "Channel video order",
            "enum": [
              "date",
              "views"
            ],
            "type": "string",
            "description": "Order of a channel's videos: newest first (Rumble's default) or most viewed first (Rumble's own sort).",
            "default": "date"
          },
          "sort": {
            "title": "Keyword result order",
            "enum": [
              "relevance",
              "date",
              "views",
              "rumbles"
            ],
            "type": "string",
            "description": "Order of keyword results (and of the trending list when no sort is in its link): relevance (the index's order), newest, most viewed or most up-voted.",
            "default": "relevance"
          },
          "uploadDate": {
            "title": "Uploaded",
            "enum": [
              "any",
              "today",
              "this-week",
              "this-month",
              "this-year"
            ],
            "type": "string",
            "description": "Only videos uploaded today, this week, this month or this year. Applied in Rumble's own channel and trending queries and in the keyword search.",
            "default": "any"
          },
          "duration": {
            "title": "Duration",
            "enum": [
              "any",
              "short",
              "long"
            ],
            "type": "string",
            "description": "Short (4 minutes or less) or long (over 20 minutes), Rumble's own presets. Applied in Rumble's own channel query; checked on every other video.",
            "default": "any"
          },
          "fetchDetails": {
            "title": "Video details (add-on)",
            "type": "boolean",
            "description": "Adds the full description, categories, every video file with its size and bitrate, the audio track, caption tracks, frame rate, share and embed links to each video (two more pages per video). Charged as one video-details event per enriched video.",
            "default": false
          },
          "includeTranscripts": {
            "title": "Transcripts (add-on)",
            "type": "boolean",
            "description": "Adds the transcript (plain text and timed segments) from the video's caption track. Charged as one transcript event per video that has captions; videos without captions are not charged.",
            "default": false
          },
          "transcriptLanguages": {
            "title": "Transcript languages",
            "type": "array",
            "description": "Preferred caption languages, e.g. <code>en</code>. Empty: English, else the first track.",
            "items": {
              "type": "string"
            }
          },
          "includeTranscriptSegments": {
            "title": "Timed transcript segments",
            "type": "boolean",
            "description": "With transcripts: also return the segments with start and end times in seconds.",
            "default": true
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Rows delivered (and charged) at most in this run, videos, channels and playlists together. 0 = no limit.",
            "default": 50
          },
          "maxItemsPerInput": {
            "title": "Max results per link or keyword",
            "minimum": 1,
            "type": "integer",
            "description": "Videos at most from each channel tab, playlist, list or keyword. Empty = no limit."
          },
          "dateFrom": {
            "title": "Uploaded on or after",
            "type": "string",
            "description": "Only videos uploaded on or after this date (YYYY-MM-DD)."
          },
          "dateTo": {
            "title": "Uploaded on or before",
            "type": "string",
            "description": "Only videos uploaded on or before this date (YYYY-MM-DD)."
          },
          "publishedWithinDays": {
            "title": "Uploaded in the last N days",
            "minimum": 1,
            "type": "integer",
            "description": "Only videos uploaded in the last N days (a rolling window for scheduled runs)."
          },
          "minViews": {
            "title": "Min views",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos with at least this many views. Channel links are then read most viewed first (Rumble's own order, so reading stops at the first page under it), except in monitor mode."
          },
          "maxViews": {
            "title": "Max views",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos with at most this many views."
          },
          "minLikes": {
            "title": "Min rumbles (up-votes)",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos with at least this many up-votes."
          },
          "minComments": {
            "title": "Min comments",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos with at least this many comments."
          },
          "minDurationSeconds": {
            "title": "Min duration (seconds)",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos at least this long."
          },
          "maxDurationSeconds": {
            "title": "Max duration (seconds)",
            "minimum": 0,
            "type": "integer",
            "description": "Only videos at most this long."
          },
          "shorts": {
            "title": "Shorts",
            "enum": [
              "include",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "Keep, drop or keep only Shorts.",
            "default": "include"
          },
          "livestreams": {
            "title": "Livestreams",
            "enum": [
              "include",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "Keep, drop (live now or upcoming) or keep only livestreams.",
            "default": "include"
          },
          "titleContains": {
            "title": "Title or description contains",
            "type": "array",
            "description": "Only videos whose title (or description, when read) contains one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Drop videos whose title (or description) contains one of these words.",
            "items": {
              "type": "string"
            }
          },
          "verifiedOnly": {
            "title": "Verified channels only",
            "type": "boolean",
            "description": "Only videos from (and channels that are) verified on Rumble.",
            "default": false
          },
          "minFollowers": {
            "title": "Min channel followers",
            "minimum": 0,
            "type": "integer",
            "description": "Channel keyword results: only channels with at least this many followers."
          },
          "maxFollowers": {
            "title": "Max channel followers",
            "minimum": 0,
            "type": "integer",
            "description": "Channel keyword results: only channels with at most this many followers."
          },
          "monitorMode": {
            "title": "Monitor mode (only new)",
            "type": "boolean",
            "description": "Remember every delivered video, channel and playlist id in a named dataset in your account (one small row per poll that finds something); later runs with the same input return only rows that are new, plus (once) videos delivered earlier without an add-on the run now asks for (changeType details). A poll with nothing new writes nothing and charges nothing.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name of the monitor's memory (letters, digits, dashes). Different inputs keep separate memories under the same name.",
            "default": "rumble-monitor"
          },
          "emitViewChanges": {
            "title": "Report view-count changes",
            "type": "boolean",
            "description": "Monitor mode: also return known videos whose views moved by at least the percentage below since the last run (changeType viewsChanged, previousViews, viewsChange).",
            "default": false
          },
          "viewChangePercent": {
            "title": "View change threshold (%)",
            "minimum": 0,
            "type": "integer",
            "description": "With view-count changes: the smallest change in percent that is reported.",
            "default": 10
          },
          "resetMonitor": {
            "title": "Reset the monitor",
            "type": "boolean",
            "description": "Forget what this monitor has seen and start over.",
            "default": false
          },
          "maxPagesPerList": {
            "title": "Max pages per list",
            "minimum": 1,
            "type": "integer",
            "description": "Pages read at most from each channel tab, category, list or playlist (25 videos a page; 50 for playlists).",
            "default": 400
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Detail and video pages read at the same time.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave empty: the actor starts on direct egress and moves one step up (Apify datacenter, then residential) only if Rumble refuses it."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}