DuckDuckGo Bangs Directory Scraper

Extracts all DuckDuckGo bang commands from duckduckgo.com/bang.js — triggers, target URLs, categories, domains, and ranks.

What this Actor collects

The Actor converts DuckDuckGo's bang directory into one clean JSON record per command, including its trigger, site, target URL template, domain, category, subcategory, rank, and HTTPS status.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 16-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Search shortcut discovery
• Bang directory and category analysis
• Command and URL-template enrichment

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
categories	array	No	[]	Filter bangs by category. Leave empty to fetch all categories.
maxCommands	integer	No	50	Maximum number of bang commands to return.
maxRequestRetries	integer	No	2	Retries for transient rate limits and server failures.
navigationTimeoutSecs	integer	No	30	Maximum time in seconds for each directory request.
headless	boolean	No	true	Run Firefox without a visible window.
proxyConfiguration	object	No	{"useApifyProxy":true}	Proxy settings for the scraper.

Example input

{
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxCommands": 50,
  "maxRequestRetries": 2,
  "navigationTimeoutSecs": 30,
  "headless": true
}

Output

The default dataset contains one item per DuckDuckGo bang command. The following are the most useful fields; category and rank values reflect the current directory response.

Field	Type	Description
command	string	Bang Command
siteName	string	Site Name
category	string	Category
subcategory	string	Subcategory
domain	string	Domain
rank	integer	Rank
isSecure	boolean	HTTPS Template
sourceUrl	string	Directory Source URL
scrapedAt	string	Scraped At
type	string	Record Type
title	string	Title
description	string	Description
url	string	URL Template
trigger	string	Trigger
urlTemplate	string	Search URL Template
searchPlaceholder	string	Search Placeholder

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "command": "!01net",
  "siteName": "01net",
  "category": "Tech",
  "subcategory": "Downloads (apps)",
  "domain": "www.01net.com",
  "rank": 0,
  "isSecure": false,
  "sourceUrl": "https://duckduckgo.com/bang.js",
  "scrapedAt": "2026-07-23T16:34:37.929Z",
  "type": "bang-command",
  "title": "01net",
  "description": "DuckDuckGo !01net command for 01net."
}

Related Actors

• Duck.ai Guest Answers Scraper
• DuckDuckGo Autocomplete Scraper
• DuckDuckGo Images Scraper