Skip to content

Video API

Isaac edited this page Apr 3, 2022 · 3 revisions

Diffbot documentation:

https://www.diffbot.com/dev/docs/video/

Usage

  let video = await diffbot.video({
    url: 'https://www.youtube.com/watch?v=HeiPdaTQTfo',
    body: 'optional-html-post-body',
  });
  console.log(video.objects[0].title);
  console.log(video.objects[0].html);

Full list of supported parameters:

Param Type Required Description
url string Yes Web page URL of the video to process
fields string[] No Used to specify optional fields to be returned by the Video API. See fields: https://www.diffbot.com/dev/docs/video/#fields
timeout number No Sets a value in milliseconds to wait for the retrieval/fetch of content from the requested URL. The default timeout for the third-party response is 30 seconds (30000).
callback string No Use for jsonp requests. Needed for cross-domain ajax.
proxy string No Used to specify the IP address of a custom proxy that will be used to fetch the target page, instead of Diffbot's default IPs/proxies. (Ex: &proxy=168.212.226.204)
proxyAuth string No Used to specify the authentication parameters that will be used with the proxy specified in the &proxy parameter. (Ex: &proxyAuth=username:password)
body string No Optional HTML markup to pass as POST body
customJS string No This functionality is currently in beta. See docs for details: https://docs.diffbot.com/docs/en/api-video#custom-javascript
customHeaders object No This functionality is currently in beta. See docs for details: https://docs.diffbot.com/docs/en/api-video#custom-headers