# Search DuckDuckGo organic results

Returns DuckDuckGo's organic results for a query, with related searches. Use it to check rankings on DuckDuckGo.

Tool `duckduckgo.serp.organic` on DuckDuckGo. Contract version 1, released 2026-10-27.

## Example call

Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`.

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/duckduckgo.serp.organic/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"crm for small teams","country":"gb"}}'
```

Python:

```python
import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/duckduckgo.serp.organic/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"query": "crm for small teams", "country": "gb"}},
    timeout=60,
)
print(response.json())
```

TypeScript:

```ts
const response = await fetch("https://api.voxoria.ai/v1/tools/duckduckgo.serp.organic/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"query": "crm for small teams", "country": "gb"}}),
});
console.log(await response.json());
```

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "duckduckgo.serp.organic",
    "input": {
      "query": "crm for small teams",
      "country": "gb"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | The search query. |
| `country` | string | No | `us` | Two-letter ISO 3166-1 country code of the region to search. Case-insensitive. DuckDuckGo sets the language of the results from it. One of the 249 values of the `countries` list: ISO 3166-1 alpha-2 country codes, lowercase. |
| `page` | integer | No | `1` | Page of results, 10 per page. At least 1. |
| `time_range` | string | No |  | Only results from the last day, week, month or year. One of `day`, `week`, `month`, `year`. |

## Output

A successful call returns these blocks in its `output`. A field not marked required can be `null`.

### results

A list of rows. Always present, possibly empty.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `position` | integer | Yes | Rank among organic results, starting at 1. |
| `title` | string | Yes |  |
| `url` | string | Yes |  |
| `snippet` | string | No |  |
| `displayed_url` | string | No | The address as DuckDuckGo shows it under the title. |

### related_searches

A list of rows. Can be `null`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes |  |

## Example output

The `output` of a real call, each list cut to 3 items.

```json
{
  "results": [
    {
      "position": 1,
      "title": "15 Best CRM Tools for Small Teams (Free + Paid)",
      "url": "https://optif.ai/media/articles/best-crm-small-teams/",
      "snippet": "Comprehensive guide to the top 15 CRM tools for small business teams in 2025. Compare pricing, features, and find the perfect fit for teams of 5-50 reps with budgets of $2K-10K/month.",
      "displayed_url": "optif.ai/media/articles/best-crm-small-teams/"
    },
    {
      "position": 2,
      "title": "15 Best CRM Tools for Small Teams in 2025 (Free + Paid) - Zenn",
      "url": "https://zenn.dev/optifai/articles/best-crm-small-teams-2025",
      "snippet": "Introduction In 2025, small to medium-sized businesses face an overwhelming challenge: choosing the right CRM from over 23,000 martech tools available in the market. A powerful CRM system can streamline operations, enhance customer relationships, and drive revenue growth—but only if it fits your team's size, budget, and technical capabilities.",
      "displayed_url": "zenn.dev/optifai/articles/best-crm-small-teams-2025"
    },
    {
      "position": 3,
      "title": "10 Best Small Business CRM Software Of 2026 - Forbes",
      "url": "https://www.forbes.com/advisor/business/software/best-crm-small-business/",
      "snippet": "Best for Teams on a Budget Zoho CRM's small brother, Bigin offers all the tools needed for startups and small teams that work on simple projects. It's user friendly and incredibly affordable.",
      "displayed_url": "www.forbes.com/advisor/business/software/best-crm-small-business/"
    }
  ],
  "related_searches": null
}
```