Logo SearchApi

DuckDuckGo Videos API Documentation

GET   /api/v1/search?engine=duckduckgo_videos
OpenAPI Initiative Download OpenAPI Spec

DuckDuckGo Videos API allows you to retrieve video search results from DuckDuckGo. Each result includes the video title, link, source, channel, description, view count, duration, published date, and a thumbnail URL. It supports locale-based targeting, date filtering, and video-specific filters like duration, resolution, and license.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    This parameter is used for the terms you want to search on DuckDuckGo Videos.

Localization

  • Name
    locale
    Required
    Optional
    Description

    Specifies the country and language for your search. The default parameter is us-en. Check the full list of supported DuckDuckGo locales.

Filters

  • Name
    time_period
    Required
    Optional
    Description

    Filters results by date. Available values are:

    • any_time Default
    • past_year
    • past_month
    • past_week
    • past_day

  • Name
    duration
    Required
    Optional
    Description

    Filters videos by duration. Available values are:

    • short - Under 5 minutes
    • medium - 5 to 20 minutes
    • long - Over 20 minutes

  • Name
    resolution
    Required
    Optional
    Description

    Filters videos by resolution. Available values are:

    • high - HD quality
    • standard - Standard quality

  • Name
    license
    Required
    Optional
    Description

    Filters videos by license. Available values are:

    • creative_common - Creative Commons licensed
    • youtube - YouTube only

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    This parameter is used to retrieve the next page of results. It is returned in the response when there are more results to display.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to duckduckgo_videos.

Api Key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Videos

Videos
GET
https://www.searchapi.io/api/v1/search?engine=duckduckgo_videos&q=cats
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "duckduckgo_videos",
  "q": "cats"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "videos": [
    {
      "position": 1,
      "title": "Cute and Funny Cat Videos to Keep You Smiling! 🐱",
      "link": "https://www.youtube.com/watch?v=tpiyEe_CqB4",
      "video_link": "https://www.youtube.com/embed/tpiyEe_CqB4?autoplay=1",
      "source": "YouTube",
      "channel": "Rufus",
      "snippet": "Hoomans! Rufus here! Cats are my best frens! I made this brand new compilation for you of my favorite Cat, Kittens and even newborn kittens pets and animals! This video is so cute! Rufus approved! hi hoomans! im rufus p goodboy and dis my yootoob channel! i has lottsa videos of doggos, good bois, cats, sleepys bois, fat bois, furry tings ...",
      "views": 15161240,
      "length": "15:46",
      "date": "2020-04-10T16:00:28.0000000",
      "thumbnail": "https://tse1.mm.bing.net/th/id/OVP.nEla1bp9xjpGNJdxGJag4AHgFo?pid=Api"
    },
    {
      "position": 2,
      "title": "THE BEST CUTE AND FUNNY CAT VIDEOS OF 2023! 🐱",
      "link": "https://www.youtube.com/watch?v=QtC3Bo9B0yI",
      "video_link": "https://www.youtube.com/embed/QtC3Bo9B0yI?autoplay=1",
      "source": "YouTube",
      "channel": "Rufus",
      "snippet": "Henlo guis!!! We made it to the end of the year! Enjoy this video of the my favorite Cats and kitten frens in this cute and funny compilaiton Dis is the best cattos of the year. I hope they do you a happy new year!! Hi hoomans! Im Rufus P. Goodboy and dis my YooToob channel! I haz lottsa videos of doggos, good bois, catz, sleepys bois, fat bois ...",
      "views": 10032065,
      "length": "58:58",
      "date": "2019-12-30T16:00:07.0000000",
      "thumbnail": "https://tse4.mm.bing.net/th/id/OVP.T8mkukCA-sgFBupIVDVscwHgFo?pid=Api"
    },
    {
      "position": 3,
      "title": "20 Minutes of Adorable Kittens 😍 | BEST Compilation",
      "link": "https://www.youtube.com/watch?v=y0sF5xhGreA",
      "video_link": "https://www.youtube.com/embed/y0sF5xhGreA?autoplay=1",
      "source": "YouTube",
      "channel": "The Pet Collective",
      "snippet": "Cute, cuddly, and utterly chaotic! These adorable kittens are jumping in the dog-pile in this collection of cute and hilarious kitty clips! 😼🥰 💕🐶Subscribe to The Scoop for our most entertaining pet videos, helpful pet parenting tips, and exclusive deals delivered straight to your email: https://bit.ly/TPCNewsLetter 😹 ️ For the ...",
      "views": 25861086,
      "length": "20:02",
      "date": "2023-05-28T13:00:44.0000000",
      "thumbnail": "https://tse3.mm.bing.net/th/id/OVP.t96w0Eroi3jaE7OETdiY-QHgFo?pid=Api"
    }
  ],
  "pagination": {
    "next_page_token": "aHR0cHM6Ly9kdWNrZHVja2dvLmNvbS92LmpzP3E9Y2F0cyZvPWpzb24mcD0xJnM9NjAmdnFkPTQtMjYzMTI1NTE4ODk1MjgwMTM4OTEyNTU2MDc3NTk2NDY5NjQzNzE3Jmw9dXMtZW4"
  }
}