> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Video > Returns a Rumble video's details by URL: title, full description (and the links in it), categories, exact views, likes and dislikes, comment count, upload time, length, resolution, frame rate and quality, thumbnails, every MP4 rendition (resolution, bitrate, file size) or the HLS playlist, the audio track, the caption languages it has, its embed link, and the channel — name, handle, avatar, followers, verified badge and ids. Accepts rumble.com/v-.html, Shorts (rumble.com/shorts/v<id>) and rumble.com/embed/v<id>/ links. Only publicly available data is returned. > [!NOTE] > > **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. > [accordion] Copy for AI assistant > > Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). > > ```text Prompt > I want to make an API call to /v1/rumble/video. Here are the details: > > Endpoint: GET https://api.scraperize.com/v1/rumble/video > Description: Returns a Rumble video's details by URL: title, full description (and the links in it), categories, exact views, likes and dislikes, comment count, upload time, length, resolution, frame rate and quality, thumbnails, every MP4 rendition (resolution, bitrate, file size) or the HLS playlist, the audio track, the caption languages it has, its embed link, and the channel — name, handle, avatar, followers, verified badge and ids. Accepts rumble.com/v<id>-<title>.html, Shorts (rumble.com/shorts/v<id>) and rumble.com/embed/v<id>/ links. Only publicly available data is returned. > > Required Headers: > - x-api-key: Your API key > > Parameters: > - url (string) [required]: The video's URL. > - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. > > Example Response: > { > "data": { > "id": "v7hvcx6", > "videoId": "449623860", > "embedId": "v7fozzo", > "url": "https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html", > "embedUrl": "https://rumble.com/embed/v7fozzo/", > "title": "71% of Voters Say Congress Isn't Doing Enough to CHECK Trump", > "description": "Watch the FULL EPISODE here: https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html\n\nSUPPORT THE SHOW BUY C…", > "descriptionLinks": [ > { > "text": "https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html", > "url": "https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html" > } > ], > "categories": [ > { > "name": "News", > "url": "https://rumble.com/category/news" > } > ], > "thumbnailUrl": "https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/1/Q/a/i/b/QaibB.qR4e-small-71-of-Voters-Say-Congress-I..jpg", > "thumbnails": [ > { > "url": "https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/1/Q/a/i/b/QaibB.qR4e-small-71-of-Voters-Say-Congress-I..jpg", > "width": 1280, > "height": 720 > } > ], > "durationSeconds": 1095, > "uploadedAt": "2026-11-06T19:00:00.000Z", > "views": 25639, > "likes": 75, > "dislikes": 10, > "commentCount": 44, > "width": 1280, > "height": 720, > "fps": 30, > "quality": "Full HD", > "isLive": false, > "mp4s": [ > { > "url": "https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.aaa.mp4", > "resolution": 721, > "width": 1280, > "height": 720, > "bitrate": 5716, > "sizeBytes": 782530809 > } > ], > "hlsUrl": null, > "audioUrl": "https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.Gaa.aac", > "captions": [ > { > "languageCode": "en-auto", > "language": "English (auto)", > "url": "https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/11/Q/a/i/b/QaibB.fn8Si.vtt", > "isAutoGenerated": true > } > ], > "channel": { > "id": "851107", > "creatorId": "36550453", > "name": "TimcastIRL", > "handle": "TimcastIRL", > "url": "https://rumble.com/c/TimcastIRL", > "avatarUrl": "https://hugh.cdn.rumble.cloud/video/z8/J/Y/p/d/JYpda.baa.2-TimcastIRL-srjiah.jpeg", > "followers": 648000, > "isVerified": true > }, > "fetchedAt": "2026-11-07T14:48:43.832Z" > }, > "meta": { > "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", > "creditsCharged": 1, > "creditsRemaining": 4999, > "cached": false > } > } > > Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. > ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/rumble/video openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer <key>`). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints - name: Instagram description: Instagram scraping endpoints - name: Lagos Life description: Lagos Life scraping endpoints - name: Bluesky description: Bluesky (bsky.app) scraping endpoints - name: Threads description: Threads (threads.com) scraping endpoints - name: Reddit description: Reddit (reddit.com) scraping endpoints - name: Rumble description: Rumble (rumble.com) scraping endpoints - name: Truth Social description: Truth Social (truthsocial.com) scraping endpoints - name: YouTube description: YouTube (youtube.com) scraping endpoints paths: /v1/rumble/video: get: tags: - Rumble summary: Video description: >- Returns a Rumble video's details by URL: title, full description (and the links in it), categories, exact views, likes and dislikes, comment count, upload time, length, resolution, frame rate and quality, thumbnails, every MP4 rendition (resolution, bitrate, file size) or the HLS playlist, the audio track, the caption languages it has, its embed link, and the channel — name, handle, avatar, followers, verified badge and ids. Accepts rumble.com/v<id>-<title>.html, Shorts (rumble.com/shorts/v<id>) and rumble.com/embed/v<id>/ links. Only publicly available data is returned. parameters: - name: url in: query required: true description: The video's URL. schema: type: string example: >- https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The video. content: application/json: schema: type: object properties: data: type: object properties: id: type: string url: type: string title: type: string nullable: true description: type: string nullable: true views: type: integer nullable: true likes: type: integer nullable: true dislikes: type: integer nullable: true durationSeconds: type: integer nullable: true mp4s: type: array items: type: object captions: type: array items: type: object channel: type: object fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: id: v7hvcx6 videoId: '449623860' embedId: v7fozzo url: >- https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html embedUrl: https://rumble.com/embed/v7fozzo/ title: 71% of Voters Say Congress Isn't Doing Enough to CHECK Trump description: >- Watch the FULL EPISODE here: https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html SUPPORT THE SHOW BUY CAST BREW COFFEE NOW - https://castbrew.com/ GET OUR MERCH - https://merch.timcast.com/ Join - https://www.youtube.com/channel/UCLwN... Hosts: Tim @Timcast (everywhere) | https://www.shoutout.fans/timpool Ian ‪@IanCrossland‬ (everywhere) Phil @PhilThatRemains (X) | https://allthatremains.komi.io/ Tate @realTateBrown (everywhere) | @TimcastTateBrown (YT) Rebeka @rebekazeljko (X) Producer: Carter @carterbanks (X) | @trashhouserecords (YT) https://carterbanks.komi.io Guests: Everyone Podcast available on all podcast platforms! For advertising inquiries please email [email protected] descriptionLinks: - text: >- https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html url: >- https://rumble.com/v7htkhi-live-midterms-democrats-accused-of-cheating-polling-locations-down-midterms.html - text: https://castbrew.com/ url: https://castbrew.com/ - text: https://merch.timcast.com/ url: https://merch.timcast.com/ categories: - name: News url: https://rumble.com/category/news thumbnailUrl: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/1/Q/a/i/b/QaibB.qR4e-small-71-of-Voters-Say-Congress-I..jpg thumbnails: - url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/1/Q/a/i/b/QaibB.qR4e-small-71-of-Voters-Say-Congress-I..jpg width: 1280 height: 720 - url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/1/Q/a/i/b/QaibB.aiEB-small-71-of-Voters-Say-Congress-I..jpg width: 720 height: 1280 durationSeconds: 1095 uploadedAt: '2026-11-06T19:00:00.000Z' views: 25639 likes: 75 dislikes: 10 commentCount: 44 width: 1280 height: 720 fps: 30 quality: Full HD isLive: false mp4s: - url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.aaa.mp4 resolution: 721 width: 1280 height: 720 bitrate: 5716 sizeBytes: 782530809 - url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.gaa.mp4 resolution: 720 width: 1280 height: 720 bitrate: 2070 sizeBytes: 283422030 - url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.caa.mp4 resolution: 480 width: 854 height: 480 bitrate: 1007 sizeBytes: 137876457 hlsUrl: null audioUrl: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/2/Q/a/i/b/QaibB.Gaa.aac captions: - languageCode: en-auto language: English (auto) url: >- https://hugh.cdn.rumble.cloud/video/fwe2/69/s8/11/Q/a/i/b/QaibB.fn8Si.vtt isAutoGenerated: true channel: id: '851107' creatorId: '36550453' name: TimcastIRL handle: TimcastIRL url: https://rumble.com/c/TimcastIRL avatarUrl: >- https://hugh.cdn.rumble.cloud/video/z8/J/Y/p/d/JYpda.baa.2-TimcastIRL-srjiah.jpeg followers: 648000 isVerified: true fetchedAt: '2026-11-07T14:48:43.832Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: No such video (it may not exist, be private or have been removed). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (`url` must be a Rumble video URL). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: url is required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer <key>`). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.