# DuckDuckGo Search API Documentation

Search the web with DuckDuckGo and retrieve organic results with title, link, snippet, and favicon. Ads and knowledge graph data are included when available. Pagination follows the upstream nav-row signal. Failed requests are never charged; a valid empty result page is a successful, charged request.

- **Documentation:** [https://scrappa.co/docs/duckduckgo-api/duckduckgo_search](https://scrappa.co/docs/duckduckgo-api/duckduckgo_search)
- **API group:** DuckDuckGo API
- **Endpoint:** `GET https://scrappa.co/api/duckduckgo/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | The search query (e.g. laravel taylor otwell). |
| `kl` | string | No | Region and locale in ll-cc format (e.g. us-en, de-de). Defaults to us-en. |
| `df` | string | No | Optional date filter: d (past day), w (past week), m (past month), y (past year). Accepted for parity; the primary transport does not carry it. |
| `safe` | boolean | No | Safe search flag. Accepted for parity; the primary transport does not carry it. |
| `start` | integer | No | Result offset for pagination (0, 10, 25...). Use the next_start value from a previous response. Defaults to 0. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/duckduckgo/search?q=laravel+taylor+otwell&kl=us-en&start=0"
```

## Example response

```json
{
    "success": true,
    "data": {
        "search_parameters": {
            "q": "laravel taylor otwell",
            "kl": "us-en",
            "df": null,
            "safe": true,
            "start": 0
        },
        "organic_results": [
            {
                "position": 1,
                "title": "Taylor Otwell - Founder & CEO at Laravel | LinkedIn",
                "link": "https://www.linkedin.com/in/taylorotwell",
                "snippet": "Founder & CEO at Laravel. Creator of Laravel.",
                "display_url": "www.linkedin.com/in/taylorotwell",
                "favicon": "https://icons.duckduckgo.com/ip3/www.linkedin.com.ico"
            }
        ],
        "ads": [],
        "pagination": {
            "current": 1,
            "has_more": true,
            "next_start": 10,
            "next": 2
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | DuckDuckGo search is temporarily unavailable. Please retry. |  |
|  | DuckDuckGo returned an unexpected response. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)