# SocialCrawl API — rumble endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/rumble

## GET /v1/rumble/search
Search Rumble videos
Credit cost: 1 (standard)
Parameters:
- query (required) — Search query.
- cursor (optional, string) — Cursor from the previous response — the next page number (e.g. `2`).
curl "https://www.socialcrawl.dev/v1/rumble/search?query=funny cats" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/rumble/channel/videos
List videos for a Rumble channel
Credit cost: 1 (standard)
Parameters:
- handle (optional, string) — Rumble channel handle.
- url (optional, string) — Rumble channel URL.
- cursor (optional, string) — Cursor from the previous response — the next page number (e.g. `2`).
- Constraint: one of handle, url (at least one required)
curl "https://www.socialcrawl.dev/v1/rumble/channel/videos" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/rumble/video
Get a Rumble video
Credit cost: 1 (standard)
Parameters:
- url (required) — Rumble video URL.
curl "https://www.socialcrawl.dev/v1/rumble/video?url=https://rumble.com/v79xhhm-discovery-example.html" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/rumble/video/transcript
Get a Rumble video transcript
Credit cost: 10 (premium)
Parameters:
- url (required) — Rumble video URL.
curl "https://www.socialcrawl.dev/v1/rumble/video/transcript?url=https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/rumble/video/comments
List top-level comments on a Rumble video
Credit cost: 1 (standard)
Parameters:
- url (required) — Rumble video URL.
curl "https://www.socialcrawl.dev/v1/rumble/video/comments?url=https://rumble.com/v792vns-example.html" \
  -H "x-api-key: sc_your_api_key_here"