duckduckgo-search-api 0.1.5

A simple and lightweight Python wrapper for DuckDuckGo search.

DuckDuckGoSearchApi

DuckDuckGoSearchApi is a Python library that provides a simple and direct interface for interacting with the DuckDuckGo API. This library is designed to simplify searches and the analysis of results from DuckDuckGo.

Instalation

To install run the following:

pip install duckduckgo_search_api

Available Methods

The Duckduckgo class offers the following main methods:

• search(query): Accepts a query string and returns search results ( ~ 20 results per input ~ )

Usage

Here's an example of how to use the DuckDuckGoSearchApi:

from ddg import Duckduckgo

ddg_api = Duckduckgo()

results = ddg_api.search("Google")

Success request

Search results are returned as a Python dictionary. Each result contains the page title, URL, and a description

{
  "success": true,
  "data": [
    {
      "title": "Page Title",
      "url": "https://www.example.com",
      "description": "Short description of the page"
    },
    
  ]
}

Error request

In case of an error the returned object will contain the success field set to false

{
  "success": false,
  "statusCode": 404,
  "message": "Failed to fetch data"
}