Apinoa Docs

Search

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

查看原始 .mdx
GET | POST /v1/yahoo-japan/search

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

请求

curl -G "https://gateway.apinoa.com/v1/yahoo-japan/search" \
  --data-urlencode "q=東京 ラーメン" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数类型必填说明
countryenumThe market, as an ISO 3166 country code. JP
cursorstringThe previous page's cursor. Pass it alone for the next page.
deviceenumWhich page to read: the desktop (default) or the mobile one. desktop mobile
limitinteger 1–100Results wanted (default 10, at most 100). More than one page is charged per page.
qstringThe query, search operators included.
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": "yahoo-japan",
    "query": "東京 ラーメン",
    "type": "web",
    "outcome": "results",
    "country": "JP",
    "device": "desktop",
    "totalResults": 95100000,
    "page": 1,
    "items": [
      {
        "type": "relatedSearches",
        "queries": ["東京 ラーメン ランキング"],
        "ext": {"shown": 3, "placement": "top"},
        "rank": 1
      },
      {
        "type": "localPack",
        "places": [
          {
            "id": "oVCz0MkZEOo",
            "name": "銀座 八五",
            "url": "https://map.yahoo.co.jp/place?gid=oVCz0MkZEOo&fr=sydd_p-grmlist-gourmet-list_gl-ttl&from_s…",
            "categories": ["ラーメン店"],
            "rating": 4.24,
            "reviewCount": 362,
            "website": "https://katsumoto-japan.com/",
            "photos": ["https://searchgourmetlist-pctr.c.yimg.jp/KD3zi0uFROIrUpGBKHZNKT29WYmZtb8_P4Hu0p54ztvnRNdPK…"],
            "ext": {
              "hoursText": "営業状況変更の可能性",
              "access": "東銀座駅[A7]徒歩2分",
              "reviewKeywords": {"items": [{"count": 55, "name": "おひとりさま向き"}], "totalCount": 215},
              "menu": [
                {
                  "imageType": "menu",
                  "imageUrl": "https://searchgourmetlist-pctr.c.yimg.jp/KD3zi0uFROIrUpGBKHZNKT29WYmZtb8_P4Hu0p54ztsiks7dD…",
                  "title": "八五ラーメン",
                  "price": "1,000円〜",
                  "poiUrl": "https://map.yahoo.co.jp/v3/place/oVCz0MkZEOo/menu/624982ffe99e5a203f9edd7f?fr=sydd_p-grmli…",
                  "isQueryMatch": true
                }
              ],
              "photoTypes": ["menu"],
              "menuUrl": "https://map.yahoo.co.jp/v3/place/oVCz0MkZEOo/menu?filter=menu&fr=sydd_p-grmlist-gourmet-li…",
              "routeUrl": "https://map.yahoo.co.jp/route/train?from=%E7%8F%BE%E5%9C%A8%E5%9C%B0&to=%E9%8A%80%E5%BA%A7…"
            },
            "reviewsUrl": "https://map.yahoo.co.jp/place?gid=oVCz0MkZEOo&tab=review&fr=sydd_p-grmlist-gourmet-list_gl…"
          }
        ],
        "ext": {
          "title": "東京周辺のラーメン(12346件)",
          "mapUrl": "https://map.yahoo.co.jp/search?q=%E6%9D%B1%E4%BA%AC%20%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%B3…",
          "source": "Yahoo!マップ"
        },
        "rank": 2,
        "moreUrl": "https://map.yahoo.co.jp/search?q=%E6%9D%B1%E4%BA%AC%20%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%B3…",
        "total": 12346
      },
      {
        "type": "organic",
        "position": 1,
        "url": "https://s.tabelog.com/ramen/tokyo/rank",
        "title": "東京で人気のラーメン・つけ麺 ランキングTOP20 - 食べログ",
        "snippet": "東京 ラーメン・つけ麺 人気ランキングTOP20 · 1らぁ麺や 嶋 · 2中華そば しば田 · 3ジャパニーズ ラーメン 五感 · 4Homemade Ramen 麦苗 · 5銀…",
        "site": "食べログ",
        "displayUrl": "s.tabelog.com/ramen/tokyo/rank",
        "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSU…",
        "ext": {"breadcrumbs": ["https://s.tabelog.com"], "exploreQueries": ["東京 ラーメン ランキング"]},
        "rank": 3,
        "images": ["https://searchysnippet-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dg…"],
        "lang": "ja"
      },
      {
        "type": "peopleAlsoAsk",
        "questions": [
          {
            "question": "東京のラーメンランキングで1位はどこですか?",
            "answer": "東京で最新の人気ラーメンを探すなら、まずは食べログの「東京都 ラーメンランキング(2026年9月1日更新)」を基準に見るのが実用的です。",
            "url": "https://tabelog.com/ramen/tokyo/rank/?msockid=10082d06807e60ee165c3bf781a7613d&utm_source=…",
            "title": "東京で人気のラーメン・つけ麺 ランキングTOP20 | 食べログ"
          }
        ],
        "ext": {
          "details": [
            {
              "sources": [
                {
                  "url": "https://tabelog.com/ramen/tokyo/rank/?msockid=10082d06807e60ee165c3bf781a7613d&utm_source=…",
                  "title": "東京で人気のラーメン・つけ麺 ランキングTOP20 | 食べログ",
                  "site": "食べログ"
                }
              ],
              "followUps": ["東京のラーメン順位は何で決まる?"]
            }
          ],
          "moreQuestions": ["東京ラーメンとはどんなラーメンですか?"]
        },
        "rank": 7,
        "title": "他の人はこちらも質問"
      }
    ],
    "cursor": "CABpuP0yN8tjQqKCzFn5exfj121ZsQYsv46xRhhTKOWs01L9ZDnrAd2NTfUfRlU1c-_chn5CvdDdp8q6QdU6P2K9GS…",
    "fetchedAt": "2026-10-30T00:58:04.163Z"
  }
}

错误

状态代码含义
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 次后单价下调。

本页内容