{"id":28901211,"url":"https://github.com/bes-dev/duckducksearch","last_synced_at":"2026-02-17T14:02:23.189Z","repository":{"id":275323614,"uuid":"925755564","full_name":"bes-dev/duckducksearch","owner":"bes-dev","description":"Simple client for duckduckgo API web search with rate limits.","archived":false,"fork":false,"pushed_at":"2025-02-01T17:29:10.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-30T01:49:32.751Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bes-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-01T17:09:34.000Z","updated_at":"2025-02-01T17:29:14.000Z","dependencies_parsed_at":"2025-02-01T17:35:25.622Z","dependency_job_id":"e45b08d5-eba0-4f9c-9419-69ab040fefb4","html_url":"https://github.com/bes-dev/duckducksearch","commit_stats":null,"previous_names":["bes-dev/duckducksearch"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bes-dev/duckducksearch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bes-dev%2Fduckducksearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bes-dev%2Fduckducksearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bes-dev%2Fduckducksearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bes-dev%2Fduckducksearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bes-dev","download_url":"https://codeload.github.com/bes-dev/duckducksearch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bes-dev%2Fduckducksearch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29546750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T13:00:00.370Z","status":"ssl_error","status_checked_at":"2026-02-17T12:57:14.072Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-21T10:08:42.000Z","updated_at":"2026-02-17T14:02:23.180Z","avatar_url":"https://github.com/bes-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DuckDuck Search Library\n\nDuckDuck Search Library is a Python library that allows you to perform searches using [DuckDuckGo](https://duckduckgo.com/). With a simple and clean API, you can quickly and easily retrieve relevant documents and links from the internet. The library supports features like rate limiting, domain filtering, and optional answer retrieval directly from DuckDuckGo.\n\n---\n\n## Features\n\n- **Easy Integration:**\n  Provides a simple and intuitive API for performing searches.\n\n- **Rate Limiting:**\n  Built-in rate limiting helps to avoid making requests too frequently.\n\n- **Domain Filtering:**\n  Restrict search results to a specific domain if required.\n\n- **Optional Answer Retrieval:**\n  Optionally fetch direct answers from DuckDuckGo.\n\n- **Flexible Configuration:**\n  Customizable parameters such as region, safe search settings, time limits, and more.\n\n- **Python 3.7+ Compatible:**\n  Designed to work with modern versions of Python.\n\n---\n\n## Installation\n\nYou can install the library via pip:\n\n### From PIP\n\n```bash\npip install duckducksearch\n```\n\n### From Source\n\n```bash\npip install git+https://github.com/bes-dev/duckducksearch.git\n```\n\n## Usage\n\n```python\nfrom duckducksearch import DuckDuckSearch\n\n# Initialize the searcher with your desired configuration.\nsearcher = DuckDuckSearch(\n    top_k=10,\n    max_results=20,\n    region=\"wt-wt\",\n    safesearch=\"moderate\",\n    allowed_domain=\"\",  # Leave empty for no domain restriction\n    use_answers=False   # Set to True if you want to retrieve direct answers from DuckDuckGo\n)\n\n# Define your search query and number of results to retrieve.\nquery = \"What is Python?\"\nnum_results = 5\n\n# Perform the search.\nresults = searcher.search(query, num_results)\n\n# Output the results.\nprint(\"Documents:\")\nfor doc in results[\"documents\"]:\n    print(f\"Title: {doc.title}\")\n    print(f\"Content: {doc.content}\")\n    print(f\"Link: {doc.link}\")\n    print(\"------------\")\n\nprint(\"Links:\")\nfor link in results[\"links\"]:\n    print(link)\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbes-dev%2Fduckducksearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbes-dev%2Fduckducksearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbes-dev%2Fduckducksearch/lists"}