Yahoo! JAPAN Search API & Scraper: parameters and responses
This is the reference for the 7 Yahoo! JAPAN Search endpoints under /yahoo-japan-search/v1 (search, images, videos, news, realtime, chiebukuro and suggest) and their 15 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
Yahoo! JAPAN (search.yahoo.co.jp) is the search engine most people in Japan use besides Google, and its results page is its own: Google's web index rendered by Yahoo, with Yahoo's ads, news, Q&A, realtime posts and knowledge panels mixed in.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON through seven actions. `search` returns the web results page as a visitor in Japan sees it: organic results with title, URL, displayed URL, snippet, date, sitelinks, star rating and video data; the paid ads above, between and below them; related searches; related questions with Yahoo's AI answers and their sources; and the inline news, images, videos, 知恵袋 answers, posts on X, knowledge panel and stock or currency answer box, with a period and a language filter and 10 results a page. `images` and `videos` are Yahoo image and video search with their size, colour, type, duration, site, HD and period filters, 20 results a page. `news` searches Yahoo! News, 50 articles a page with publisher, categories and publish time, optionally inside one category. `realtime` is Yahoo realtime search: public posts on X, newest first or most popular, with counts, hashtags, links and media, and a cursor for older posts. `chiebukuro` searches Yahoo! 知恵袋 questions with status, answer and view counts and category, and `suggest` returns the search-box suggestions for what has been typed so far.
What a Yahoo! JAPAN Search field actually contains
Fields that read differently from how they look. Every row was measured against live Yahoo! JAPAN answers on 2026-11-06.
| Field | What it holds |
|---|---|
| ads (search) | The paid ads Yahoo! JAPAN shows a visitor in Japan, each with block (top, middle or bottom), title, snippet, displayed URL, domain, advertiser, the click link and sitelinks. link and the sitelink links are Yahoo's ad click links (rd.listing.yahoo.co.jp): opening one counts as a paid click for the advertiser, so use displayed_url or domain for the advertiser's site. Yahoo serves ads only to Japanese visitors: the same queries read from the United States returned no ads at all. 9 of the 44 queries checked carried ads, up to 8 per page (ホテル 予約, 転職 エージェント, 英会話 オンライン). |
| search_information (search) | exit_country is the country the page was read from (JP normally) and ads_included says whether ads could be present. If every Japanese exit fails, the page is read from the United States: organic results are complete, ads is empty, and a warning says so. local_area names the area Yahoo placed the visitor in when the page shows a local block (area, latitude, longitude), otherwise null. |
| Localised results (search) | Yahoo! JAPAN localises results to the city it places the visitor in, which follows the Japanese network exit of the call; there is no location parameter. Local queries change most: ホテル 予約 read three times in a row on 2026-11-06 was placed in 東京都荒川区, 東京都板橋区 and 名古屋市千種区. Every search answer carries a warning saying so, and local_area names the area when the page shows it. |
| total_results (search) | The 約…件 hit count exactly as the page prints it. It is not stable: the same page printed 1,270,000, 1,230,000 and 102 on three reads. Do not use it to size a crawl; page until pagination.has_next is false. |
| pagination (search) | Yahoo! JAPAN goes about 20 to 40 pages deep, not as far as total_results suggests. last_page_reached is true on the site's own last page; a page past it returns no results with stop_reason past_last_page. |
| related_questions (search) | Questions Yahoo shows beside the results. When Yahoo has written an AI answer for one, answer holds it and sources lists the pages it cites, each once. |
| published_at (news) | Japan time. Yahoo! News prints month, day and time without a year (11/6(金) 20:01, kept in published_text); the year is the current one in Japan, or the previous one for a date that would otherwise be in the future. |
| next_cursor (realtime) | Pass it back unchanged for the next 10 older posts. It carries Yahoo's own rewritten query and the oldest post id, so every page continues where the last one stopped: 10 follow-up pages checked, 100 of 100 posts older than the first page and none repeated. Popular order is a single page of up to 40 posts. |
| status (chiebukuro) | open (回答受付中), resolved (解決済み) or empty for questions in voting. status=open returned only open questions on every page checked. |
| spelling (images, videos) | Set when Yahoo searched for a corrected query instead of yours (did you mean); results are for searched_query. |
Snippets, titles and post text come back as plain text: Yahoo's highlight tags and markers are removed (0 left in 362 live answers). Every organic URL returned was also a link on the page Yahoo served (506 of 506).
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/yahoo-japan-search/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "富士山"
}
}{
"ok": true,
"meta": {
"api": "yahoo-japan-search",
"endpoint": "search",
"mode": "live",
"latency_ms": 2258.3,
"record_count": 7,
"bytes": 1032460,
"cache_hit": false,
"upstream_requests": 1,
"ads_count": 0,
"warnings": [
"Yahoo! JAPAN localises results to the city it places the visitor in, which follows the Japanese network exit used for this request and can change between calls; local queries (hotels, restaurants, shops) can differ from one call to the next"
],
"charged_credits": 2,
"version": "0.1.1",
"request_id": "2b4f6569024546ad",
"queue_ms": 1.1,
"fetched_at": "2026-11-06T16:39:44.063Z"
},
"data": {
"query": "富士山",
"page": 1,
"filters": {
"period": "any",
"language": null
},
"total_results": 39300000,
"display_range": "1〜10件目",
"organic_results": [
{
"position": 1,
"rank_on_page": 1,
"title": "富士山 - Wikipedia",
"url": "https://ja.wikipedia.org/wiki/%E5%AF%8C%E5%A3%AB%E5%B1%B1",
"displayed_url": "ja.wikipedia.org/wiki/富士山",
"breadcrumbs": [
"wiki",
"富士山"
],
"site_name": "Wikipedia",
"snippet": "富士山は独立峰でよく目立ち、日本の最高峰であることからその高さが注目されてきた。福田履軒が観測する以前の認識としては、『月刈藻集』に「直立25町」（2750 m）、『塵 ...",
"date": null,
"sitelinks": [
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]",
"snippet": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]",
"snippet": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]",
"snippet": "[trimmed-depth]"
}
],
"rating": null,
"video": null,
"thumbnail": "https://searchysnippet-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpaRTIzubCeXddSc1lOlsWV5gxvIty6aKa2ivie_UMNT3eJDkIyxIfJRp2S5MGbw2FXkAii1zWZ-srM-hFU7lquiDjXRpazJqjYmyaYJfnJIChs6uf15yV7gBhtmfDUgrLh6T5J3gPDyOhQm4NWV52kW9OpmN3QJU8u5hn4R5q0DFHvNZM49pW398rVaCsQ22SwEsFe62P0kv8xdR9BW6o-3l_flpCaz4aRNQR6qlszyoT9qOOgT8krxYBcmxHU6uCg=="
},
{
"position": 2,
"rank_on_page": 2,
"title": "富士登山オフィシャルサイト",
"url": "https://www.fujisan-climb.jp/",
"displayed_url": "www.fujisan-climb.jp/",
"breadcrumbs": [],
"site_name": "富士登山オフィシャルサイト",
"snippet": "すべての登山者が富士山を“安全に登り”“無事に帰る”ためのオフィシャル情報サイトです。 富士山 火山情報. 参照： 2026/11/05 16:00.",
"date": null,
"sitelinks": [],
"rating": null,
"video": null,
"thumbnail": "https://searchysnippet-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpdUoyi3Eg8maoxuMNlOKeVw5Qjas5330oJybHx20Q2N02A3pk21c_Awcf3f86FPBRvJzT9rjyraRagQF5x0G8aF3HwAHPP23BzXc47AY-Fa1bBZJAvLAwGNxlnRTWPdsRQLyYluo9TxHzL_RZduKtRqeXv4k4ny1IoLAR7Fl6YIPazr6AKZKC3LoFdBovIL5RBqiExGr-5XmD2d8XmsIf7eTgoNgsdUV0WzYRrjhUF5086RxMRW12xQFFb-niT1IAg=="
},
{
"position": 3,
"rank_on_page": 3,
"title": "ライブカメラ富士山ビュー｜静岡県公式ホームページ",
"url": "https://www.pref.shizuoka.jp/fujisanview/index.html",
"displayed_url": "www.pref.shizuoka.jp/fujisanview/index.html",
"breadcrumbs": [
"fujisanview"
],
"site_name": "静岡県公式ホームページ",
"snippet": "富士山ライブ映像マップ. 富士山ライブ映像の撮影地10地点を示した静岡県の略地図. 富士山配信中. Live Camera. 富士山画像. 現在の富士山の様子 (富士宮). 開始 停止.",
"date": null,
"sitelinks": [],
"rating": null,
"video": null,
"thumbnail": "https://searchysnippet-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpYVYsSlJz87IT6j8g9mZcpk7OSMOkUovv9JPVXuNrTqSzczVvNj5RnSamcMnEoNCtCinxctFV7MjOJnTlLWd0ZLgkpSCMAaGluOdCI1tXrYEUFz0kZY92y-3W_uJ6FDR8Adn1wdbFxi4CzQ_vJ5Sdm2NPBTPYHHZNbHTXQAHXclasUb14SSjdV_xHyU1lW_okTYCb6i0_qAdkFkm9Pf3UeFx_RNyizfMayCpm_l2IdQ-F6eyE1YKWzsCwqItVyT2AA=="
}
],
"ads": [],
"related_searches": [
{
"query": "富士山ライブカメラ"
},
{
"query": "富士山 初冠雪"
},
{
"query": "富士山 噴火"
}
],
"explore_queries": [
"富士山ライブカメラ",
"富士山 噴火",
"富士山五合目"
],
"related_questions": [],
"top_stories": [
{
"title": "新幹線から「富士山」見ることができるのはA席orE席？ クイズに「天気のいい日だったら」",
"url": "https://news.yahoo.co.jp/articles/a505ab988cfdca803a381537449bf0b48c5cb6a1",
"source": "オトナンサー",
"date": "2026-11-06T21:15:00+09:00",
"snippet": "東海道新幹線の車両清掃や整備などを手掛ける新幹線メンテナンス東海（東京都中央区）が公式インスタグラムアカウントで新幹線にまつわるクイズを出題しています。 同社は「知ってて当然！？新幹線の常識クイズに挑...",
"thumbnail": "https://searchnews-pctr.c.yimg.jp/nHaycXA-A453uc2PJxMU36queQRXQ-kjyTQqVUs_i7byCWSqLwC50BzhX5CH1Y043CDBTTbUGhxV8cQfH2ynukVPnF2prBKAA3-k04y9xinMF9_qLODKG6wkKAzx7sk8t7_0azs-4GYyrU-bIkviKc_3_iLRHapMj67BDKsoWnzC-F_PC1EKYK_tIg9BKpNTiMGPG7jVvoPJ7sJJOrtYYcU9RYh-GHfM2s9gy6qjZhBGAAieslOHEHTo42P-bmPLOrQ1QGUtyH_duq8TFpUI2hM59pCmQ3PgUD7EipsQQ8DYiOgjVhLgnqJtPJHYK5Ot"
},
{
"title": "西武・冨士大和 富士山に“日本一投手”の誓い「トップまでいきたい」",
"url": "https://news.yahoo.co.jp/articles/60312e8be8261bfdf982b5af9fb41ce430aaa7f2",
"source": "スポニチアネックス",
"date": "2026-11-06T05:10:00+09:00",
"snippet": "西武の冨士が霊峰・富士に日本一の誓いを立てた。静岡県伊豆市での秋季キャンプでインターバル走や筋トレで追い込み「富士山は日本の最高峰。自分もそれに倣いトップまでいきたい」と掲げた。 高卒2年目の今季は開...",
"thumbnail": "https://searchnews-pctr.c.yimg.jp/nHaycXA-A453uc2PJxMU386VuX3rjcLAmhJEIhIfXMJsX0ExwVDobY6L3371KuelVgyC_MKQ5-K6vfeh5aZemiFGLxBtHe-obwyA3lVUwkuaFhqa5DR8R_szk_N1zNpO_48dQUwGGvSeGrs_-okKnnoE4TkrtXOH4SJRdOkcDx4ZaSCG9c96HgEq7ebpVdIKYM6bK5MMyW8OXPUeCGvp8MKOAQusVnY07TlBvG29QHsvcnVd4kZvNnv2sZ649h0OSwdo9f_G7Nkd4jvsgqhB9Tcila3vnO8TOdtTcocswistjoJCXJdPtH5aLZIMiCQi"
},
{
"title": "日本一の山に集う研究者 「富士山測候所を活用する会」が20周年",
"url": "https://news.yahoo.co.jp/articles/688fff51831ddedda9f00e8bf0b7e639b6eb6c61",
"source": "毎日新聞",
"date": "2026-11-05T16:17:49+09:00",
"snippet": "富士山頂に建つ気象庁の旧富士山測候所を利用し、さまざまな研究活動を行うために設立された認定NPO法人「富士山測候所を活用する会」が、設立20周年を迎えた。近年は高層での「マイクロプラスチック」の研究などで...",
"thumbnail": "https://searchnews-pctr.c.yimg.jp/nHaycXA-A453uc2PJxMU3wQEnAIkif8gJdWb51qW_x8ABObDEmu4zrseIHQsx1IGquaDgCoV0d7gOqgXJk9XBjgJkm3NmcADm_C6Hvkppw5wzhAeXzmM2z4bEkpkVp_Lorjo7t1KGZK9KjmyOK1oqyn1suP7go-DwEj5XRTzOMh2JJ6s-GVWMEohAXJqVp70i0bypEBwYlT9b5ywBTMD70m7Ns_QR9UMGIcBO6DczZvhZEfBXHaTLT7Q2F48XxQGsp_AgxyZYSRIefjgWXManT_IuMNNV8T8bVb8i6GiRyzcw4uOBtV3vLMjqKl-QIxo"
}
],
"inline_images": [
{
"title": "富士山絶景動画集】富士山を眺めて、富士山に癒されよう ...",
"original": "https://cdn.fujiyama-navi.jp/entries/images/000/004/969/large/35d2f641-43ce-4322-9c5a-89ed8db6f710.jpg?1587547174",
"thumbnail": "https://searchgisearch-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpePkXcRzfB0Uzvxw461LXjpsa_tmg5lIxhSd9ysLyCOrPKsAyN7WGTzPD6jUOSlLl9JxcNltKUu0SKoig2ZgpI9qqEWWTqhBsZ0RjxmRoUbP0k-TupBVWmzfZ3rljCrBzjgDOOIZsruC79O4xHiXyLizcnacugQsOSkFW5linJWInRbiawvj8_EM3fDnCWOZDxVhWyQB01fxsv3l1dFgcBo=",
"source_url": "https://www.fujiyama-navi.jp/entries/YO6I6",
"source": "フジヤマNAVI",
"width": 1200,
"height": 800
},
{
"title": "富士山 - Wikipedia",
"original": "https://thumb.wikimedia.org/wikipedia/commons/thumb/5/55/Mt.Fuji_from_Mierula.jpg/330px-Mt.Fuji_from_Mierula.jpg?utm_source=ja.wikipedia.org&utm_campaign=parser&utm_content=thumbnail",
"thumbnail": "https://searchgisearch-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpQa7qf3NL145UoE3bzSMSHwe3iu7Jsn6kf1r0bSA18R5zBxgO_AJ4t0YEnVFPHOHklDklWHw8ZqVVDsxTUp0sekwK5pgH7oGCS92xt5QsN31DTtWTOmLqbu3UbTJG9Us3jH5vmIkFz7fA4hzrxeW9gU8C4lYv-5HOaIaEeHUWFHmG7FQ4BqMjPOyyK6_kPCxUbydRxrwtFEJRsj1uKZEmRQ=",
"source_url": "https://ja.wikipedia.org/wiki/%E5%AF%8C%E5%A3%AB%E5%B1%B1",
"source": "Wikipedia",
"width": 330,
"height": 247
},
{
"title": "富士山",
"original": "https://fujisan.ne.jp/wp/wp-content/uploads/2026/02/k-022_kv-scaled.jpg",
"thumbnail": "https://searchgisearch-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpRkFklUm353WapFPHy7mFBoD_dP84TFELpwpmzKBVHFWQSKPuxU5zO8BVflFr1xC5b8vdWJBj1UZRADC_8wwcGGI4E7e4K13LFWT308pFP4RLdHQqiYgow8n63k9Sxu8AAcpZwweFmLXA6kIqEVcHRuKOGnm2cBPqBCr2SRZ8N7l1UqyYv2MiOCIMkJdeuZx5uHn-ZPxQGmQfqaqBi8KcHE=",
"source_url": "https://fujisan.ne.jp/sightseeing/1555/",
"source": "富士河口湖町観光連盟",
"width": 2560,
"height": 1707
}
],
"inline_videos": [
{
"title": "個人情報流出の可能性 富士山の通行予約システムを使用した約27 ...",
"url": "https://newsdig.tbs.co.jp/articles/uty/3063725?display=1",
"source": "TBS NEWS DIG",
"channel": "UTYテレビ山梨公式チャンネル",
"duration": "1:16",
"published": "1日前",
"thumbnail": "https://searchmms-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpZV3I3NuGB5EBhsGWHXjegDDsgsbP0cILqjZjfBJJLSm5ET5DDEFh58ZNhaN2rXzYMw2jXbbeZtJSJ7nbobELkonPx_NN_zr1vVZDw3YvXdLrFRQWGm0Ay2GkADJL8q0ukypF88CrArruyghHOGiz6zYZ6XeBeEYNqq_N8W_SUb77hXOFc6vCJn7nJ58cYXb-dfRXUpGL_PRbculgLiRuy5HDS1LUUBnADQy5n-9K_QJKbvnyCkAQWbjrxw-MY1qYw=="
},
{
"title": "【LIVE】静岡市さった峠 広重の富士山 / Mt. Fuji (World Heritage Site)",
"url": "https://www.youtube.com/watch?v=GsD9QQEKSzQ",
"source": "YouTube",
"channel": "静岡市さった峠 ライブカメラ",
"duration": "--:--",
"published": null,
"thumbnail": "https://searchmms-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpUv0S4sTXc1pgIYC9RASubeFHM9-vsfBJNnhXO9f2aaNnPgGTlMcu7JKfepyiSnMA47U6jKWlWGmYtpI0jsVbqJ6th7HxoCS3LM7ZmIBem82j60eQwDmUhB4S3J-1iIx1KzRt3MLQpln_5qVeVldiSYPnQwI8d9V_Xtyv-EboxavCiL-FwtbLzo7IdOQKVJGPVNdSqfKwzWA5i02qG3Zr4r_pys82c3M0-O9nV4o2odHA0KnJ6KNXo7d1f7uUdE_wA=="
},
{
"title": "【4K】富士山ライブカメラ / 4K Live Camera Mt.FUJI ～河口湖～ ...",
"url": "https://www.youtube.com/watch?v=Sv9hcJ3k5h4",
"source": "YouTube",
"channel": "フジヤマNAVI",
"duration": "--:--",
"published": "2020/11/24",
"thumbnail": "https://searchmms-pctr.c.yimg.jp/uUzvQ3lML_bkIqyakc1vFi9yrQXh6avYqqVdgqvBtiCaArZ038dgzq0AjLCkVL83dd2wtZP0oXGnTjgtoCrlpRGw7P4p6qWhd_emV53oWxASNGrmpI_Hdo51b5pOUM3XSrB9b89OEZ---ZhO_vQzYthM6cM8ArBQQkRfdkaAWWeKlZPi8LMxLtIYvByXM2MShasnGSYJfaZ79r9P6ntaKb6aH4QlBdjagb3oEiQLV14XFHpSy3a9wKIXSP1IdXeEB63wbABfzJkEoSyCVqrTxr71r5VraBOECtHbjWovC7hDyaMWaT27WqRx9sqPE9v1kPO0aPk238KQkFC3cdXecw=="
}
],
"chiebukuro": [],
"realtime_posts": [],
"knowledge_panel": {
"kind": "lsr_where",
"name": "富士山",
"reading": "ふじさん"
},
"answer_box": null,
"modules": [
"LeisureWhereRightAggregateShortcut",
"LeisureWhereLeftAggregateShortcut",
"NewsShortcut"
],
"pagination": {
"current": 1,
"has_next": true,
"last_page_reached": false
},
"search_information": {
"exit_country": "JP",
"ads_included": true,
"local_area": null
}
}
}What the Yahoo! JAPAN Search API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | The Yahoo! JAPAN web results page (search.yahoo.co.jp) as a person in Japan sees it: organic results with title, URL, displayed URL, snippet, date, sitelinks, star rating and video data; the paid ads above, between and below them; related searches; related questions with Yahoo's AI answers and their sources; and the blocks Yahoo mixes into the page — news, images, videos, 知恵袋 Q&A, posts on X, a knowledge panel, stock and currency answer boxes. 10 results a page; date and language filters. Results are localised to the Japanese city Yahoo places the visitor in, which follows the network exit used for the call and can change between calls (local queries such as hotels or restaurants differ most); there is no location parameter, and search_information.local_area names the area when the page shows a local block. Ad `link` and sitelink links are Yahoo's ad click links (rd.listing.yahoo.co.jp): opening one counts as a paid click; `displayed_url` and `domain` name the advertiser's site. | SEO teams call search to get the Yahoo! JAPAN web results page (search.yahoo.co.jp) as a person in Japan sees it. | query, page, period, language |
| images | Yahoo! JAPAN image search: 20 images a page with the full-size image URL and size, the Yahoo-hosted copy and thumbnail, the page it comes from, the site name and format; plus related searches, the refinement chips and any did-you-mean rewrite. Size, colour, type and period filters. | Content strategists call images to get yahoo! JAPAN image search. | query, page, size, color, type, ... |
| videos | Yahoo! JAPAN video search across YouTube, Dailymotion, niconico and other sites: 20 videos a page with the watch URL, title, site, channel, duration, upload date, description, thumbnail and preview clip. Duration, period, site and HD filters. | Rank trackers call videos to get yahoo! JAPAN video search across YouTube, Dailymotion, niconico and other sites. | query, page, duration, period, site, ... |
| news | Yahoo! News (news.yahoo.co.jp) article search, newest first: 50 articles a page with headline, the matching passage, publisher, categories, publish time (Japan time) and article URL. Category filter. | AI answer-monitoring tools call news to get yahoo! News (news.yahoo.co.jp) article search, newest first. | query, page, category |
| realtime | Yahoo! JAPAN realtime search (リアルタイム検索): public posts on X matching the query, newest first or most popular, with text, author, time, replies / reposts / quotes / likes, hashtags, links and media; Yahoo's featured post and the trending topics it shows beside them. Up to 40 posts on the first call; pass `next_cursor` back for older posts (10 per call, newest-first order only). | SEO teams call realtime to get yahoo! JAPAN realtime search (リアルタイム検索). | query, sort, media, cursor |
| chiebukuro | Yahoo! 知恵袋 (Yahoo! Chiebukuro, Japan's largest Q&A site) question search: 10 questions a page with title, the start of the question, status (open / resolved / voting), posted time, answer count, view count and category path. Status filter and the site's eleven sort orders. | Content strategists call chiebukuro to get yahoo! 知恵袋 (Yahoo! Chiebukuro, Japan's largest Q&A site) question search. | query, page, status, sort |
| suggest | Yahoo! JAPAN search-box suggestions (the autocomplete list) for what has been typed so far, in Japanese or English, kana or kanji. | Rank trackers call suggest to get yahoo! JAPAN search-box suggestions (the autocomplete list) for what has been typed so far, i…. | query |
Call search from your stack
curl -X POST https://api.reefapi.com/yahoo-japan-search/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"富士山"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/yahoo-japan-search/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "富士山"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/yahoo-japan-search/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "富士山"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.yahoo-japan-search.search with {"query":"富士山"}.Who uses this API and why
- Track rankings on Yahoo! JAPAN for Japanese and English keywords, page by page, with the ads competing for the same query.
- Monitor which advertisers buy a keyword in Japan and what their ad copy and sitelinks say.
- Follow a brand or topic on Yahoo! News and on X through Yahoo realtime search, with publish times in Japan time.
- Collect real questions people ask on 知恵袋 about a product or topic, with answer and view counts.
- Build Japanese keyword lists from search-box suggestions, related searches and related questions.
Questions developers ask before integrating
Do I need a Yahoo! JAPAN ID, an appid or a Japanese IP?
No. Everything is read logged out from the public site, and you call reefapi.com from anywhere. The web results page is read through Japan so that you get the page, and the ads, a visitor in Japan gets.
Is this the same as Google Japan?
The organic results come from Google's index, but the page is Yahoo's own: Yahoo's ads, Yahoo! News, 知恵袋, realtime posts on X, Yahoo knowledge panels and stock and currency boxes. Of the 60 result pages read on 2026-11-06, 26 carried a knowledge panel, 21 related questions, 17 a 知恵袋 block and 14 a news block.
Can I search in English?
Yes. English and Japanese both work, and language=en keeps only English pages: sushi returned kura sushi and other Japanese chains in Japanese and Wikipedia, Tripadvisor and Yelp in English. News, realtime and 知恵袋 are Japanese services, so English-only queries can return few or no results there (yen exchange rate had no Yahoo! News match; yen alone had 186).
Which filters are there?
search: period (past hour to past year) and language. images: size, colour, type, period. videos: duration, period, site (YouTube, Dailymotion, niconico) and HD. news: category. realtime: newest or popular, image or video posts only. chiebukuro: open or resolved, and the site's eleven sort orders. Each was checked live: images size=icon returned 20 of 20 images 256 px wide and size=large none under 800 px; videos duration=short returned 36 to 206 seconds and duration=long 1,218 to 12,284 seconds; realtime media=image returned 40 of 40 posts with media.
How do I get more realtime posts?
The first call returns up to 40 posts. Pass next_cursor back for the next 10 older posts, as many times as you like. Popular order (sort=popular) is one page.
What happens when there is no result?
You get ok with an empty list and stop_reason no_match, after the empty answer was confirmed from a second exit. Yahoo sometimes serves a complete results page with no results by mistake; that is retried from other exits and never reported as no match.
How fast is it?
Median 1.1 to 2.5 seconds per call depending on the action, measured over 362 live calls: suggest 1.1 s, news 1.3 s, videos 1.5 s, images 1.7 s, chiebukuro 1.7 s, realtime 1.8 s, search 2.5 s.
What is the Yahoo! JAPAN Search API?
Yahoo! JAPAN Search API is a ReefAPI endpoint group for yahoo! japan search results as json: web results with the ads people in japan see, images, videos, yahoo! news, posts on x from realtime search, 知恵袋 q&a and search suggestions. It returns live JSON through POST requests under /yahoo-japan-search/v1.
Is the Yahoo! JAPAN Search API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Yahoo! JAPAN Search calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Yahoo! JAPAN Search login or account?
No login to Yahoo! JAPAN Search is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Yahoo! JAPAN Search data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Yahoo! JAPAN Search API use?
Yahoo! JAPAN Search actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Yahoo! JAPAN Search from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call yahoo-japan-search actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Yahoo! JAPAN Search API a Yahoo! JAPAN Search scraper?
It is the managed alternative to a DIY Yahoo! JAPAN Search scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same yahoo! japan search results as json: web results with the ads people in japan see, images, videos, yahoo! news, posts on x from realtime search, 知恵袋 q&a and search suggestions back as clean JSON.