# Yahoo! JAPAN Search API — web results with ads, images, videos, news, realtime posts on X, 知恵袋 Q&A and search suggestions from search.yahoo.co.jp

> 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.
> ReefAPI engine `yahoo-japan-search` · 7 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/yahoo-japan-search/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/yahoo-japan-search/v1/search — 2 credits
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.

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `page` (integer, optional, default 1) — Result page, 10 results per page (1-100).
- `period` (enum, optional, default "any") — Only pages updated within this period (Yahoo's 最終更新 filter). [one of: any, hour, day, week, month, 3months, 6months, year]
- `language` (string, optional) — Only pages in this language, as a 2-letter code (ja, en, ko, zh, fr, de, …; Yahoo's 言語 filter, 36 languages).

**Returns:** query, page, total_results (as printed), organic_results[]{position, title, url, displayed_url, breadcrumbs[], site_name, snippet, date, sitelinks[]{title, url, snippet}, rating{value, review_count}, video{duration, source, uploader, upload_date}, thumbnail}, ads[]{position, block (top|middle|bottom), title, snippet, displayed_url, domain, advertiser, link, sitelinks[]}, related_searches[]{query}, explore_queries[], related_questions[]{question, answer, sources[]}, top_stories[], inline_images[], inline_videos[], chiebukuro[], realtime_posts[], knowledge_panel, answer_box, modules[], pagination{current, has_next, last_page_reached}, search_information{exit_country, ads_included, local_area{area, latitude, longitude}}

**Example request body:**
```json
{
  "query": "富士山"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/images — 1 credit
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.

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `page` (integer, optional, default 1) — Result page, 20 results per page (1-50).
- `size` (enum, optional, default "any") — Image size. [one of: any, large, medium, icon]
- `color` (enum, optional, default "any") — Colour. [one of: any, black_and_white, transparent]
- `type` (enum, optional, default "any") — Image type. [one of: any, line_drawing, animated]
- `period` (enum, optional, default "any") — Only images found within this period. [one of: any, day, week, month, year]

**Returns:** query, page, total_results, results[]{position, id, title, original, original_width, original_height, image, thumbnail, format, source_url, source, domain, date}, related_searches[], refinements[], spelling, has_more

**Example request body:**
```json
{
  "query": "猫"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/videos — 1 credit
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.

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `page` (integer, optional, default 1) — Result page, 20 results per page (1-50).
- `duration` (enum, optional, default "any") — Video length. [one of: any, short, medium, long]
- `period` (enum, optional, default "any") — Uploaded within this period. [one of: any, hour, day, week, month, year]
- `site` (enum, optional, default "any") — Only videos from this site. [one of: any, youtube, dailymotion, niconico]
- `hd` (boolean, optional, default false) — Only HD videos (高画質).

**Returns:** query, page, total_results, results[]{position, id, title, url, site, source, channel, duration, description, published, thumbnail, preview}, related_searches[], has_more

**Example request body:**
```json
{
  "query": "富士山"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/news — 1 credit
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.

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `page` (integer, optional, default 1) — Result page, 50 results per page (1-20).
- `category` (enum, optional, default "all") — Only articles in this Yahoo! News category. [one of: all, domestic, world, business, entertainment, sports, it, science, life, local]

**Returns:** query, page, total_results, results[]{position, id, title, url, snippet, source, source_id, categories[], article_type, published_text, published_at, has_video, thumbnail}, has_more

**Example request body:**
```json
{
  "query": "日銀"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/realtime — 1 credit
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).

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `sort` (enum, optional, default "recent") — Order of posts. [one of: recent, popular]
- `media` (enum, optional, default "all") — Only posts with media. [one of: all, image, video]
- `cursor` (string, optional) — `next_cursor` from the previous call, unchanged, for the next 10 older posts (newest-first order).

**Returns:** query, sort, total_results, results[]{id, url, text, date, user{name, screen_name, id, profile_image, badge}, replies, reposts, quotes, likes, hashtags[], links[], media[], in_reply_to, quoted_post_id, possibly_sensitive}, best_post, trending[], next_cursor

**Example request body:**
```json
{
  "query": "富士山"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/chiebukuro — 1 credit
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.

**Parameters:**
- `query` (string, required) — Search words, Japanese or English, exactly as you would type them into Yahoo! JAPAN (operators such as "quoted phrase" and site: are passed through). Full-width letters and digits are normalised.
- `page` (integer, optional, default 1) — Result page, 10 results per page (1-100).
- `status` (enum, optional, default "all") — Question status. [one of: all, open, resolved]
- `sort` (enum, optional, default "relevance") — Order (the site's own). [one of: relevance, newest, oldest, updated_newest, updated_oldest, most_answers, fewest_answers, most_views, fewest_views, most_thanks, fewest_thanks]

**Returns:** query, page, total_results, results[]{position, question_id, url, title, snippet, status, status_text, posted, posted_at, answer_count, view_count, category_path[], category_id}, has_more

**Example request body:**
```json
{
  "query": "富士山"
}
```

### POST https://api.reefapi.com/yahoo-japan-search/v1/suggest — 1 credit
Yahoo! JAPAN search-box suggestions (the autocomplete list) for what has been typed so far, in Japanese or English, kana or kanji.

**Parameters:**
- `query` (string, required) — What has been typed so far (kana, kanji or latin).

**Returns:** query, suggestions[]{position, suggestion, kind}

**Example request body:**
```json
{
  "query": "ふじさ"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=yahoo-japan-search
- Human docs page: https://reefapi.com/docs/yahoo-japan-search
- Overview page: https://reefapi.com/yahoo-japan-search-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt