Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

SearchAPI.io - DuckDuckGo Search API

SearchAPI.io tool searchapi-io-duckduckgo on looot: input fields, $0.004 per call, output shape, and code to run it with curl, JavaScript or Python.

DuckDuckGo Search API provides web search results from DuckDuckGo’s search engine. This API offers organic search results, ads, AI-powered answers, knowledge graph data, inline images and videos, top stories, and related searches. The API supports pagination through next page tokens, safe search filtering, locale-based search, and time period filtering. Cross-linking: The search results returned by this API can be used with other SearchAPI engines for deeper insights or related searches based on the content found.

  • Tool id: searchapi-io-duckduckgo
  • Provider: SearchAPI.io
  • Job: Duckduckgo search (search.duckduckgo)
  • Price: $0.004 per call. A call that fails at the provider costs $0.

Inputs

Name Type Required Description
engine string no Fixed to “duckduckgo” for this endpoint. Example: “duckduckgo”
locale string no
next_page_token string no
q string yes
safe string no
time_period string no

Output

Shape of the run’s result, checked against 1 real answer:

{ ads: { link, title, source, favicon, snippet, position, sitelinks: { link, title, tracking_link }[], tracking_link, snippet_highlighted_words: string[] }[], pagination: { next_page_token }, ai_overview: { answer, sources: { link, title, source }[] }, organic_results: { date, link, title, favicon, snippet, position, snippet_highlighted_words: string[] }[], search_metadata: { id, status, html_url, json_url, created_at, request_url, total_time_taken, parsing_time_taken, request_time_taken }, related_searches: { link, query }[], search_parameters: { q, safe, engine, locale, time_period } }

Run it

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"searchapi-io-duckduckgo","input":{"q":"<q>","engine":"duckduckgo"},"wait":30}'
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "searchapi-io-duckduckgo",
    input: {
      q: "<q>",
      engine: "duckduckgo",
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "searchapi-io-duckduckgo",
        "input": {
            "q": "<q>",
            "engine": "duckduckgo",
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:search.duckduckgo as endpointId; see the job page.

Was this page helpful?