# DuckDuckGo Search API
### Parameters
#### Scrapingdog Parameters
| Parameter | Description |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| api\_key
required
| Your personal API key. Available on your dashboard.
Type: String
|
| html | This will return the full HTML of the Google page.
Default Value - false
Type - String
|
#### Search Query
| Parameter | Description |
| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| query
required
| This parameter specifies the search query. You can enter any terms or operators you would normally use in a standard DuckDuckGo search (e.g., inurl:, site:, intitle:, etc.).
Type - String
|
#### Localization
| Parameter | Description |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| kl | This parameter sets the region for the DuckDuckGo search. For example: us-en for the United States, uk-en for the United Kingdom, or fr-fr for France. Refer to the DuckDuckGo regions page for the full list of supported region codes.
Type - String
|
#### Advanced DuckduckGo Filters
| Parameter | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| df | This parameter filters results by date. Options include:
- d: Past day
- w: Past week
- m: Past month
- y: Past year
You can also specify a custom range using the format: from\_date..to\_date (e.g., 2021-06-15..2024-06-16).
Type - String
|
#### Pagination
| Parameter | Descriptio |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| next\_page\_token | This parameter specifies the next page token, used to fetch subsequent results. Each page returns 15 results.
Type - String
|
### API Example
{% tabs %}
{% tab title="cURL" %}
```bash
curl "https://api.scrapingdog.com/duckduckgo/search/?api_key=5eaa61a6e562fc52fe763tr516e4653&query=football"
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
api_key = "5eaa61a6e562fc52fe763tr516e4653"
url = "https://api.scrapingdog.com/duckduckgo/search/"
params = {
"api_key": api_key,
"query": "football"
}
response = requests.get(url, params=params)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Request failed with status code: {response.status_code}")
```
{% endtab %}
{% tab title="Node JS" %}
```javascript
const axios = require('axios');
const api_key = '5eaa61a6e562fc52fe763tr516e4653';
const url = 'https://api.scrapingdog.com/duckduckgo/search/';
const params = {
api_key: api_key,
query: 'football'
};
axios
.get(url, { params: params })
.then(function (response) {
if (response.status === 200) {
const data = response.data;
console.log(data)
} else {
console.log('Request failed with status code: ' + response.status);
}
})
.catch(function (error) {
console.error('Error making the request: ' + error.message);
});
```
{% endtab %}
{% tab title="PHP" %}
```php
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.