Getting Started — Welcome!

Welcome to DuckDuckHack!

We are a community of DuckDuckGo users who help improve the search engine with, "Instant Answers". To get started, join our developer email list and read the guide below:

If you have any questions while making your Instant Answer, feel free to email the list above or reach us at:

What are Instant Answers?

Instant Answers help you find what you're looking for in few or zero clicks. They're placed above ads and regular search results, and they're created/maintained by you (the community). Some Instant Answers are built from pure code and others require external sources (API requests), databases, or key-value stores. The possibilities are endless but the point is to provide a perfect result for every search.

App search Instant Answer example

In the above example, Quixey was a source that our own DuckDuckHack Community suggested for mobile app search. Now, any time someone searches for apps on DuckDuckGo, we request information directly from Quixey to help answer the search. Here, we'll show you how to build Instant Answers that can do this and more!

How can I contribute?

Create new Instant Answers.
Use this documentation to develop a new Instant Answer

Improve Current Instant Answers.
Fix issues in our zeroclickinfo repositories

Code review and help
Help with pull requests in our zeroclickinfo repositories

Discuss Instant Answers.
Help others with their ideas

Start

Instant Answers come in all varieties but we encourage everyone to work on an Instant Answer they're genuinely passionate about. The section below will help you refine your ideas.

Forming your Idea

If you've never created an Instant Answer before, please start by working on a pre-approved Instant Answer idea.

If you've already built an Instant Answer (the quick-start goodie doesn't count), think of the searches you do most often:

  • What has always frustrated you about the results?
  • What do you wish "just worked?"
  • Is there a website or source of data that would help answer most/all of those searches?

A great example is the CourseBuffet Instant Answer. Rubydubee (the contributor) created an Instant Answer powered by CourseBuffet's API make searching for online courses easier: https://duckduckgo.com/?q=computer+science+online+course&ia=onlinecourses

A simpler example can be found with the dice Instant Answer. Want to virtually throw a pair of dice? How about 5 dice? You can do it on DuckDuckGo: https://duckduckgo.com/?q=throw+2+dice&ia=answer

In both of these examples, users will more easily find what they're looking for via the Instant Answers provided, instead of clicking through regular results. If you're still unsure of what to build, you can work on an idea from our community or get help with your idea here: https://duck.co/ideas

Improve Another Idea

You can check if your idea has already been suggested or implemented in the Ideas forum and Instant Answers index. If it already exists (as an idea or a live Instant Answer), you can still contribute to it. Let us know how you'd like to improve the Instant Answer using the same steps below for, "Submitting Your Idea."

Submitting Your Idea

The most important step in creating Instant Answers is to let the DuckDuckGo staff and community know that you're getting started. Sometimes, we cannot accept a submitted Instant Answer because the implementation or source are not up to our standard. There are multiple ways to reach out:

If choosing email, this sample will help you craft your message:

To: open@duckduckgo.com
Subject: Awesome Instant Answer Idea

I'd like to make an Instant Answer to help people searching for <topic/subject>!
When someone searches for <your trigger idea>, it would be cool if they could see <your response idea>.
I'm going to accomplish this with a <Goodie/Spice/Fathead/Longtail> type Instant Answer.
This is the data source: <link, description, Perl module, etc.>.
This is the related Duck.co idea: <url, if applicable>.
This is my Github username: <username>.

Thanks!

PS: DuckDuckGo is awesome!

With every channel, we'll try and get back to you as soon as possible (ideally within 24hrs). We ask that you wait to hear back from us before moving ahead unless you're absolutely sure this Instant Answer is acceptable (e.g. a duck.co idea that has been approved by DDG staff).

Creating Your Own Instant Answer

After getting approval, you'll need to determine your Instant Answer back-end type.

Not helpful? Help Edit or Ask the Community