Search
Yahoo! JAPAN 검색 결과 페이지 하나를 가져옵니다. 모든 블록이 페이지 순서대로 옵니다.
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"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
country | enum | The market, as an ISO 3166 country code. JP | |
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
device | enum | Which page to read: the desktop (default) or the mobile one. desktop mobile | |
limit | integer 1–100 | Results wanted (default 10, at most 100). More than one page is charged per page. | |
q | string | The query, search operators included. | |
timeRange | enum | Only results from this past period. hour day week month year | |
type | enum | What 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"
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_CURSOR | 이 오퍼레이션이 돌려준 cursor가 아닙니다. cursor 없이 처음부터 다시 호출하세요. |
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | SERVICE_UNAVAILABLE | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.0012, 추가 호출마다 $0.0012 — 최대 9번 더, 합계 최대 $0.012. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.