# DuckDuckGo Search API

### Basic Information

**Interface Description:** Retrieve real-time search data from DuckDuckGo via API.

**Interface URL:** <https://scraperapi.thordata.com/request>

**Request Method:** <mark style="color:green;">POST</mark>

### Request parameters

**Headers：**

<table><thead><tr><th width="130.3333740234375">Parameter name</th><th width="130.55560302734375">Type</th><th width="129.6666259765625">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>Yes</td><td>Please log in to the <a href="https://dashboard.thordata.com/account-settings">Dashboard-account-settings</a> to view your <code>token</code></td></tr></tbody></table>

**Body：**

<table><thead><tr><th width="130.22222900390625">Parameter</th><th width="130.22222900390625">Type</th><th width="129.888916015625">Required</th><th width="358.4444580078125">Description</th></tr></thead><tbody><tr><td><code>q</code></td><td>string</td><td>Yes</td><td>Defines the search query for scraping (default: q=pizza). Supports any keyword in any language.<br>For a list of possible values, see <a href="https://duckduckgo.com/duckduckgo-help-pages/settings/params/">Query Parameter</a></td></tr><tr><td><code>format</code></td><td>string</td><td>No</td><td>This parameter defines the output format of the crawl results. <br><code>json=1</code> for JSON, <br><code>json=2</code> for both,<br><code>json=3</code> for HTML.</td></tr><tr><td><code>kl</code></td><td>string</td><td>No</td><td>Specify the interface language and region for search results .For a list of possible values, see <a href="https://duckduckgo.com/duckduckgo-help-pages/settings/params/#kl">Region/Lang</a></td></tr><tr><td><code>start</code></td><td>string</td><td>No</td><td>Set the pagination starting point for search results (e.g., 'start=1 skips the first 1 results and displays from the 2st).For a list of possible values, see <a href="https://duckduckgo.com/duckduckgo-help-pages/settings/params/#s">Pagination</a></td></tr><tr><td><code>df</code></td><td>string</td><td>No</td><td>Filter search results by time range ('<code>d</code>=last 24 hours', '<code>w</code> = last week', '<code>m</code> = last month').For a list of possible values, see <a href="https://duckduckgo.com/duckduckgo-help-pages/settings/params/#df">Time Filter</a></td></tr><tr><td><code>kp</code></td><td>string</td><td>No</td><td>Set the security filter level for search content (Strict/Medium/Off).For a list of possible values, see <a href="https://duckduckgo.com/duckduckgo-help-pages/settings/params/#kp">SafeSearch</a></td></tr></tbody></table>

### Response example

```json
    {
    "spider_parameter": {
        "engine": "duckduckgo",
        "q": "pizza"
    }
    "search_metadata": {
        "created_at": "2025-06-21 14:08:06",
        "id": "xxx",
        "url": "https://duckduckgo.com/search?q=pizza"
    },
    "result":{}
```

<table><thead><tr><th width="170.33331298828125">Parameter Name</th><th width="129.77783203125">Type</th><th width="129.6666259765625">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>spider_parameter</code></td><td>object</td><td>yes</td><td>Search engine parameters configuration</td></tr><tr><td> <code>engine</code></td><td>string</td><td>yes</td><td>Search engine type </td></tr><tr><td><code>q</code></td><td>string</td><td>yes</td><td>Search keyword</td></tr><tr><td><code>search_metadata</code></td><td>object</td><td>yes</td><td>Metadata of the search</td></tr><tr><td> <code>created_at</code></td><td>string</td><td>yes</td><td>Timestamp of the search</td></tr><tr><td> <code>id</code></td><td>string</td><td>yes</td><td>Unique task ID</td></tr><tr><td><code>url</code></td><td>string</td><td>yes</td><td>Full URL of the search request</td></tr><tr><td><code>result</code></td><td>string</td><td>yes</td><td>Return Result</td></tr></tbody></table>