Apinoa Docs

Search

获取一页 DuckDuckGo 搜索结果,所有区块按页面顺序返回。

查看原始 .mdx
GET | POST /v1/duckduckgo/search

参数可以用 GET 的查询字符串发送,也可以用 POST 的 JSON 请求体发送,两者等价。

请求

curl "https://gateway.apinoa.com/v1/duckduckgo/search?q=best+running+shoes&country=US" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数类型必填说明
countryenumThe market, as an ISO 3166 country code. US GB CA AU IN DE FR IT ES NL BR MX JP KR
cursorstringThe previous page's cursor. Pass it alone for the next page.
limitinteger 1–100Results wanted (default 10, at most 100). More than one page is charged per page.
qstringThe query, search operators included.
safeenumSafe search. on off
timeRangeenumOnly results from this past period. hour day week month year
typeenumWhat to search: web results (default), news, images or videos. web news images videos

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 ResultsPage。 真实响应的节选:数组只保留前几项,长文本已截断。

{
  "success": true,
  "data": {
    "engine": "duckduckgo",
    "query": "best running shoes",
    "type": "web",
    "outcome": "results",
    "country": "US",
    "device": "desktop",
    "page": 1,
    "items": [
      {
        "type": "shopping",
        "items": [
          {
            "title": "On Men's Cloudboom Echo 3 Road Running Shoe In White/Flame, Size: 11.5",
            "url": "https://www.on.com/en-us/products/cloudboom-echo-3-0-3md1059/mens/white-flame-shoes-3MD10590256?variant=11.5&m…",
            "price": "$260.00",
            "lowPrice": "$130.00",
            "merchant": "On Running",
            "thumbnail": "https://www.bing.com/th?id=OPHS.JAt6Xy%2bZyO2cXA474C474&o=5&pid=21.1",
            "snippet": "A fusion of CloudTec® and Helion™ HF hyper foam for our fastest race-day shoe. Get ready to outrun your echo |…",
            "sponsored": true,
            "clickUrl": "https://duckduckgo.com/y.js?ad_domain=on.com&ad_provider=bing&ad_type=prad&click_metadata=YPxo%2D6r%2DBu%2Dx6n…"
          },
          {
            "title": "On Men's Cloudmonster 3 Road Running Shoe In Eclipse/Ivory, Size: 11.5, Polyester",
            "url": "https://www.on.com/en-us/products/cloudmonster-3-m-3mg1005/mens/eclipse-ivory-shoes-3MG10053388?variant=11.5&m…",
            "price": "$190.00",
            "lowPrice": "$150.00",
            "merchant": "On Running",
            "thumbnail": "https://www.bing.com/th?id=OPHS.I93vHyie0KB%2fFg474C474&o=5&pid=21.1",
            "snippet": "We've levelled up the latest Cloudmonster, bringing back the forward-rolling ride you love. Now featuring a tr…",
            "sponsored": true,
            "clickUrl": "https://duckduckgo.com/y.js?ad_domain=on.com&ad_provider=bing&ad_type=prad&click_metadata=%2DyfPGA7EWq4tBoRb_K…"
          }
        ],
        "rank": 1,
        "sponsored": true
      },
      {
        "type": "ad",
        "block": "top",
        "url": "https://ad.doubleclick.net/searchads/link/click?lid=43700081731586309&ds_s_kwgid=58700008871720321&ds_a_cid=68…",
        "title": "Built For Runners, By Runners - Supportive Running Shoes",
        "snippet": "Stay Supported On Every Run With Durable, High-Performance Running Shoes. Shop Brooks® Running Shoes & Apparel…",
        "advertiser": "Brooks Running",
        "displayUrl": "www.brooksrunning.com",
        "sitelinks": [
          {
            "url": "https://ad.doubleclick.net/searchads/link/click?lid=43700081731586309&ds_s_kwgid=58700008871720321&ds_a_cid=68…",
            "title": "Adrenaline GTS 25"
          },
          {
            "url": "https://ad.doubleclick.net/searchads/link/click?lid=43700081731586309&ds_s_kwgid=58700008871720321&ds_a_cid=68…",
            "title": "Try Our Shoe Finder"
          }
        ],
        "ext": {
          "clickUrl": "https://duckduckgo.com/y.js?ad_domain=brooksrunning.com&ad_provider=bingv7aa&ad_type=txad&click_metadata=fZ6OU…"
        },
        "rank": 2,
        "favicon": "https://www.bing.com/th?id=OADD2.1242448182628032_1DRPH90YYKI2O5R&pid=21.2&h=32"
      },
      {
        "type": "organic",
        "position": 1,
        "url": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
        "title": "The 15 Best Running Shoes of 2026, Tested by Runner's World",
        "snippet": "Find the best running shoes of 2026, including Runner's World-tested picks from Adidas, Brooks, New Balance, N…",
        "site": "Runner's World",
        "displayUrl": "www.runnersworld.com/gear/a19663621/best-running-shoes/",
        "date": "2026-10-22",
        "sitelinks": [
          {
            "url": "https://www.runnersworld.com/gear/a20865766/best-stability-running-shoes/",
            "title": "Stability",
            "snippet": "Through rigorous testing and a lifetime of runs, we've determined the best stability running shoes on the mark…"
          },
          {
            "url": "https://www.runnersworld.com/gear/a26028922/running-shoes-for-men/",
            "title": "Men's Running Shoe Reviews",
            "snippet": "From freaky fast racers to rock-solid stability shoes, these are the highest-rated running shoes for men that…"
          }
        ],
        "rank": 5,
        "lang": "en"
      },
      {
        "type": "topStories",
        "items": [
          {
            "title": "Heads up: 2026's best running shoes are already marked down by as much as 45%",
            "url": "https://www.msn.com/en-us/lifestyle/other/heads-up-2026-s-best-running-shoes-are-already-marked-down-by-as-muc…",
            "source": "Outside Online",
            "date": "2026-10-25T09:22:46.000Z",
            "snippet": "Looking to upgrade your running shoes without paying full price? We rounded up four top-tested road trainers a…"
          },
          {
            "title": "Hoka updated one of its best running shoes for pain-free walks and runs—now the cloud-like sneakers are on sal…",
            "url": "https://www.msn.com/en-us/news/other/hoka-updated-one-of-its-best-running-shoes-for-pain-free-walks-and-runs-n…",
            "source": "EatingWell",
            "date": "2026-10-21T10:00:00.000Z",
            "snippet": "A plush yet supportive design? We're in.",
            "thumbnail": "https://www.bing.com/th?id=ONUT.4Ma08_mymEhVGpW5Wj7ryg&pid=News"
          }
        ],
        "rank": 10
      },
      {
        "type": "relatedSearches",
        "queries": ["best running shoes for men", "best running shoes for women"],
        "rank": 17
      }
    ],
    "cursor": "rhDukN2wfKxmHVjTS25-olD-Z_d_Rj_ivX3a4765VdFFfm17ma1zcpp495WtWkFT0nZiEO37qbSIQUFRDbYYe2Cgue7tkw_XBJhrSgAhiZ8iGL…",
    "fetchedAt": "2026-10-30T00:57:50.542Z"
  }
}

错误

状态代码含义
400INVALID_CURSOR该 cursor 不是本操作返回的。请不带它重新开始。
400INVALID_PARAMS参数缺失、未知、超出范围,或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012,每多一次调用加 $0.0012——最多再加 9 次,合计最多 $0.012。标价;单日调用超过 1,000 次后单价下调。

本页内容