Subscribe to a channel — webhook on every new video

Subscribe to a creator/channel URL on a supported platform. FrameFetch polls the channel on a schedule and POSTs a new_video event (see the new_video webhook) to your webhook_url for each new upload — no polling on your side. The webhook_url is SSRF-hardened at creation and re-validated before every delivery (must be a public https URL; localhost, loopback, private/RFC1918, link-local and cloud-metadata addresses are rejected). Subscribing does not backfill the existing catalogue — you only receive videos posted after you subscribe. Up to 50 active subscriptions per account. Creating/listing/deleting a subscription is never billed — but each SUCCESSFULLY delivered new_video webhook costs $0.0001 per delivered notification, charged once per delivery. If the account balance is at or below zero when a new video is found, the subscription is paused (active:false) rather than deleted or left to accrue debt — no further webhooks fire until you top up and re-enable it (top-up alone does not auto-resume a paused subscription).

post/v1/watch

Request

  • Base URL: https://framefetch.net
  • URL: https://framefetch.net/v1/watch
  • Auth: HTTP bearer

Request body

channelstring uri required

Creator/channel URL on a supported platform (e.g. https://www.youtube.com/@creator).

webhook_urlstring uri required

Public https URL that receives new_video events. SSRF-hardened: private/loopback/link-local/metadata addresses are rejected.

Response

Subscription created

Changes

No recorded changes to this operation across all 1 revision of this API.