# Social Fetch API - Rumble endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

5 documented Rumble operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/rumble/search
Search Rumble
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/rumble/search/get.mdx
SDK: client.rumble.search({ query: "breaking news" })
Parameters:
- query (required, string) - Search query text for Rumble content.
- cursor (optional, string) - Page number from a previous response.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Disambiguation: Use `data.page.hasMore` and `data.page.nextCursor` for pagination rather than inferring completion from `data.totalResults` alone.
curl "https://api.socialfetch.dev/v1/rumble/search?query=breaking news" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/rumble/channels/videos
List Rumble channel videos
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/rumble/channels/videos/get.mdx
SDK: client.rumble.listChannelVideos({ url: "https://rumble.com/c/StevenCrowder" })
Parameters:
- url (required, string) - Link to the Rumble channel.
- cursor (optional, string) - Page number from a previous response.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/rumble/channels/videos?url=https://rumble.com/c/StevenCrowder" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/rumble/videos
Get Rumble video
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/rumble/videos/get.mdx
SDK: client.rumble.getVideo({ url: "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html" })
Parameters:
- url (required, string) - Link to the Rumble video.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/rumble/videos?url=https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/rumble/videos/transcript
Get Rumble video transcript
Credit cost: 1 credit when a transcript is found; no charge when captions are unavailable.
Docs: https://www.socialfetch.dev/docs/api/v1/rumble/videos/transcript/get.mdx
SDK: client.rumble.getVideoTranscript({ url: "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html" })
Parameters:
- url (required, string) - Link to the Rumble video.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `lookup_failed`
curl "https://api.socialfetch.dev/v1/rumble/videos/transcript?url=https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/rumble/videos/comments
List Rumble video comments
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/rumble/videos/comments/get.mdx
SDK: client.rumble.listVideoComments({ url: "https://rumble.com/v792vns-the-splc-is-a-deceitful-and-poisonous-group.-but-was-their-behavior-crimina.html" })
Parameters:
- url (required, string) - Link to the Rumble video.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/rumble/videos/comments?url=https://rumble.com/v792vns-the-splc-is-a-deceitful-and-poisonous-group.-but-was-their-behavior-crimina.html" \
  -H "x-api-key: YOUR_API_KEY"