https://github.com/Snazzah/duck-duck-scrape

🔎 Search from DuckDuckGo and utilize its spice APIs in Node
https://github.com/Snazzah/duck-duck-scrape

api-client duckduckgo hacktoberfest search

Last synced: about 1 month ago
JSON representation

🔎 Search from DuckDuckGo and utilize its spice APIs in Node

• Host: GitHub
• URL: https://github.com/Snazzah/duck-duck-scrape
• Owner: Snazzah
• License: mit
• Created: 2018-04-07T18:44:24.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-07-18T14:07:38.000Z (5 months ago)
• Last Synced: 2024-10-30T01:47:47.945Z (about 2 months ago)
• Topics: api-client, duckduckgo, hacktoberfest, search
• Language: TypeScript
• Homepage: https://duck-duck-scrape.js.org
• Size: 1.53 MB
• Stars: 138
• Watchers: 4
• Forks: 18
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        


[![](https://get.snaz.in/45RrSvq.png)](https://duck-duck-scrape.js.org/)

[![NPM version](https://img.shields.io/npm/v/duck-duck-scrape?maxAge=3600?&color=3498db)](https://www.npmjs.com/package/duck-duck-scrape) [![NPM downloads](https://img.shields.io/npm/dt/duck-duck-scrape?maxAge=3600&color=3498db)](https://www.npmjs.com/package/duck-duck-scrape) [![ESLint status](https://github.com/Snazzah/duck-duck-scrape/workflows/ESLint/badge.svg)](https://github.com/Snazzah/duck-duck-scrape/actions?query=workflow%3A%22ESLint%22) [![DeepScan grade](https://deepscan.io/api/teams/11596/projects/16764/branches/365136/badge/grade.svg)](https://deepscan.io/dashboard#view=project&tid=11596&pid=16764&bid=365136)

`npm install duck-duck-scrape` - `yarn add duck-duck-scrape`

Search from DuckDuckGo and utilize its spice APIs for things such as stocks, weather, currency conversion and more!



### Available Features

- Search

  - Regular search

  - Image search

  - Video search

  - News search

- Stocks (via Xignite)

- Time for Location API (via timeanddate.com)

- Currency Conversion (via XE)

- Forecast (via Dark Sky)

- Dictionary

  - Definition

  - Audio

  - Pronunciation

  - Hyphenation

### Quickstart

#### JavaScript

```js

const DDG = require('duck-duck-scrape');

const searchResults = await DDG.search('node.js', {

  safeSearch: DDG.SafeSearchType.STRICT

});

// DDG.stocks('aapl')

// DDG.currency('usd', 'eur', 1)

// DDG.dictionaryDefinition('happy')

console.log(searchResults);

/**

{

  noResults: false,

  vqd: '3-314...',

  results: [

    {

      title: 'Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript...',

      ...

      url: 'https://nodejs.org/',

      bang: {

        prefix: 'node',

        title: 'node.js docs',

        domain: 'nodejs.org'

      }

    },

    ...

  ]

}

*/

```

#### TypeScript

```js

import { search, SafeSearchType } from 'duck-duck-scrape';

// import * as DDG from 'duck-duck-scrape';

const searchResults = await search('node.js', {

  safeSearch: SafeSearchType.STRICT

});

```