The Rumble API from Social Fetch — 5 operation(s) for rumble.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/social-fetch-rumble-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Social Fetch Public Rumble API
version: 1.0.0
description: 'REST API for Social Fetch. Versioned routes under `/v1` accept `x-api-key` credits or x402 USDC on Base (walk-up, no key). OpenAPI: https://api.socialfetch.dev/openapi.json. x402 discovery: https://api.socialfetch.dev/.well-known/x402. MCP: https://api.socialfetch.dev/mcp (POST). Docs and agent guide: https://www.socialfetch.dev/docs and https://www.socialfetch.dev/llms.txt.'
servers:
- url: https://api.socialfetch.dev
description: API origin
tags:
- name: Rumble
paths:
/v1/rumble/channels/videos:
get:
tags:
- Rumble
summary: List Rumble channel videos
description: List videos and Shorts from a Rumble channel.
security:
- ApiKeyAuth: []
- {}
x-socialfetch-pricing:
version: 1
baseCredits: 1
surcharges: []
maxCredits: 1
normalizationFailureCredits: 1
x-socialfetch-credits-pricing: 1 credit per successful request.
parameters:
- schema:
type: string
minLength: 1
maxLength: 4096
description: Link to the Rumble channel.
required: true
description: Link to the Rumble channel.
name: url
in: query
- schema:
type: string
minLength: 1
description: Page number from a previous response.
required: false
description: Page number from a previous response.
name: cursor
in: query
responses:
'200':
description: Videos and Shorts for the requested channel.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
lookupStatus:
type: string
enum:
- found
- not_found
description: Whether the channel was resolved for this request.
channel:
type:
- object
- 'null'
properties:
name:
type:
- string
- 'null'
description: Channel display name when available.
handle:
type:
- string
- 'null'
description: Channel handle when available.
url:
type:
- string
- 'null'
description: Canonical public channel URL when available.
required:
- name
- handle
- url
description: Resolved channel metadata when available.
videos:
type: array
items:
type: object
properties:
id:
type: string
minLength: 1
description: Rumble content identifier.
kind:
type: string
enum:
- video
- short
- live
description: Normalized media kind for this row.
url:
type:
- string
- 'null'
description: Canonical public URL for this item when available.
title:
type:
- string
- 'null'
description: Title shown for this item.
thumbnailUrl:
type:
- string
- 'null'
description: Thumbnail image URL when available.
channel:
type:
- object
- 'null'
properties:
name:
type:
- string
- 'null'
description: Channel display name when available.
handle:
type:
- string
- 'null'
description: Channel handle when available.
url:
type:
- string
- 'null'
description: Canonical public channel URL when available.
required:
- name
- handle
- url
description: Channel metadata when available.
viewCount:
type:
- integer
- 'null'
minimum: 0
description: View count when available.
viewCountText:
type:
- string
- 'null'
description: Human-readable view count label when available.
publishedAt:
type:
- string
- 'null'
description: ISO-8601 publish timestamp when available.
publishedTimeText:
type:
- string
- 'null'
description: Human-readable relative publish time when available.
durationSeconds:
type:
- integer
- 'null'
minimum: 0
description: Duration in seconds when available.
durationText:
type:
- string
- 'null'
description: Human-readable duration label when available.
badges:
type: array
items:
type: string
description: Display badges when present.
required:
- id
- kind
- url
- title
- thumbnailUrl
- channel
- viewCount
- viewCountText
- publishedAt
- publishedTimeText
- durationSeconds
- durationText
- badges
description: A video, short, or live stream row in Rumble list results.
description: Videos returned for the resolved channel. This array may be empty when the channel resolves but there are no videos in the returned page.
shorts:
type: array
items:
type: object
properties:
id:
type: string
minLength: 1
description: Rumble content identifier.
kind:
type: string
enum:
- video
- short
- live
description: Normalized media kind for this row.
url:
type:
- string
- 'null'
description: Canonical public URL for this item when available.
title:
type:
- string
- 'null'
description: Title shown for this item.
thumbnailUrl:
type:
- string
- 'null'
description: Thumbnail image URL when available.
channel:
type:
- object
- 'null'
properties:
name:
type:
- string
- 'null'
description: Channel display name when available.
handle:
type:
- string
- 'null'
description: Channel handle when available.
url:
type:
- string
- 'null'
description: Canonical public channel URL when available.
required:
- name
- handle
- url
description: Channel metadata when available.
viewCount:
type:
- integer
- 'null'
minimum: 0
description: View count when available.
viewCountText:
type:
- string
- 'null'
description: Human-readable view count label when available.
publishedAt:
type:
- string
- 'null'
description: ISO-8601 publish timestamp when available.
publishedTimeText:
type:
- string
- 'null'
description: Human-readable relative publish time when available.
durationSeconds:
type:
- integer
- 'null'
minimum: 0
description: Duration in seconds when available.
durationText:
type:
- string
- 'null'
description: Human-readable duration label when available.
badges:
type: array
items:
type: string
description: Display badges when present.
required:
- id
- kind
- url
- title
- thumbnailUrl
- channel
- viewCount
- viewCountText
- publishedAt
- publishedTimeText
- durationSeconds
- durationText
- badges
description: A video, short, or live stream row in Rumble list results.
description: Shorts returned for the resolved channel. This array may be empty when the channel resolves but there are no Shorts in the returned page.
page:
type: object
properties:
nextCursor:
type:
- string
- 'null'
description: Next page number when more results are available.
hasMore:
type: boolean
description: Whether another page of results is available.
required:
- nextCursor
- hasMore
description: Pagination information for the current response.
required:
- lookupStatus
- channel
- videos
- shorts
- page
description: Endpoint-specific response payload.
meta:
type: object
properties:
requestId:
type: string
minLength: 1
description: Unique request identifier for tracing this API call.
creditsCharged:
type: integer
minimum: 0
description: Credits charged for this request.
version:
type: string
enum:
- v1
description: Public API version that served the response.
cached:
type: boolean
description: True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
required:
- requestId
- creditsCharged
- version
description: Metadata describing the request and billing outcome.
required:
- data
- meta
description: Standard success response envelope.
examples:
found:
value:
data:
lookupStatus: found
channel:
name: Steven Crowder
handle: StevenCrowder
url: https://rumble.com/c/StevenCrowder
videos:
- id: v2oadka
kind: video
url: https://rumble.com/v2oadka--live-daily-show-louder-with-crowder.html
title: 'F*CK YOUTUBE: CROWDER HIT 5x! IT''S TIME TO UNITE! | Louder with Crowder'
thumbnailUrl: https://hugh.cdn.rumble.cloud/s/s8/1/A/T/E/H/ATEHj.0kob-small--LIVE-COVERAGE-TRUMP-CNN-TO.jpg
channel: null
viewCount: 1220000
viewCountText: 1.22M views
publishedAt: '2023-05-17T14:10:00-04:00'
publishedTimeText: 2 years ago
durationSeconds: 7032
durationText: '1:57:12'
badges: []
shorts: []
page:
nextCursor: '2'
hasMore: true
meta:
requestId: req_01example
creditsCharged: 1
version: v1
no_videos:
value:
data:
lookupStatus: found
channel:
name: Steven Crowder
handle: StevenCrowder
url: https://rumble.com/c/StevenCrowder
videos: []
shorts: []
page:
nextCursor: null
hasMore: false
meta:
requestId: req_01example_empty
creditsCharged: 1
version: v1
not_found:
value:
data:
lookupStatus: not_found
channel: null
videos: []
shorts: []
page:
nextCursor: null
hasMore: false
meta:
requestId: req_01example_nf
creditsCharged: 1
version: v1
'400':
description: Invalid query parameters
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- bad_request
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: bad_request
message: Example message.
requestId: req_01example
'401':
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- unauthorized
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: unauthorized
message: Example message.
requestId: req_01example
'402':
description: Insufficient credits
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- insufficient_credits
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: insufficient_credits
message: Example message.
requestId: req_01example
'500':
description: Unexpected or billing error
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- internal_error
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: internal_error
message: Example message.
requestId: req_01example
'502':
description: Lookup could not be completed from the response (unexpected or invalid data).
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- lookup_failed
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: lookup_failed
message: Example message.
requestId: req_01example
'503':
description: Service temporarily unavailable; safe to retry with backoff.
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- temporarily_unavailable
description: Machine-readable error code for the failed request.
message:
type: string
description: Human-readable error message. May change over time; do not parse it. Use `error.code` and the HTTP status for programmatic handling.
requestId:
type: string
description: Unique request identifier for tracing the failed API call.
checkoutUrl:
type: string
format: uri
description: Optional one-click checkout URL when credits are exhausted and a conversion offer is available.
required:
- code
- message
- requestId
description: Error details for the failed request.
required:
- error
description: Standard error response envelope.
example:
error:
code: temporarily_unavailable
message: Example message.
requestId: req_01example
operationId: getV1RumbleChannelsVideos
x-operation-id-source: derived
/v1/rumble/search:
get:
tags:
- Rumble
summary: Search Rumble
description: Search Rumble for videos and Shorts by keyword.
security:
- ApiKeyAuth: []
- {}
x-socialfetch-agent-hints:
disambiguation: Use `data.page.hasMore` and `data.page.nextCursor` for pagination rather than inferring completion from `data.totalResults` alone.
x-socialfetch-pricing:
version: 1
baseCredits: 1
surcharges: []
maxCredits: 1
normalizationFailureCredits: 1
x-socialfetch-credits-pricing: 1 credit per successful request.
parameters:
- schema:
type: string
minLength: 1
maxLength: 512
description: Search query text for Rumble content.
required: true
description: Search query text for Rumble content.
name: query
in: query
- schema:
type: string
minLength: 1
description: Page number from a previous response.
required: false
description: Page number from a previous response.
name: cursor
in: query
responses:
'200':
description: Search results for the requested query.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
query:
type: string
description: Search query string evaluated for this response.
videos:
type: array
items:
type: object
properties:
id:
type: string
minLength: 1
description: Rumble content identifier.
kind:
type: string
enum:
- video
- short
- live
description: Normalized media kind for this row.
url:
type:
- string
- 'null'
description: Canonical public URL for this item when available.
title:
type:
- string
- 'null'
description: Title shown for this item.
thumbnailUrl:
type:
- string
- 'null'
description: Thumbnail image URL when available.
channel:
type:
- object
- 'null'
properties:
name:
type:
- string
- 'null'
description: Channel display name when available.
handle:
type:
- string
- 'null'
description: Channel handle when available.
url:
type:
- string
- 'null'
description: Canonical public channel URL when available.
required:
- name
- handle
- url
description: Channel metadata when available.
viewCount:
type:
- integer
- 'null'
minimum: 0
description: View count when available.
viewCountText:
type:
- string
- 'null'
description: Human-readable view count label when available.
publishedAt:
type:
# --- truncated at 32 KB (123 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/social-fetch/refs/heads/main/openapi/social-fetch-rumble-api-openapi.yml