# Rakuten Travel name search: `POST /v1/ota/rakuten/search`

Cost: 1 credit (1 per lookup (no match and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/rakuten-search

Rakuten Travel hotel numbers for a hotel name, from Rakuten's own
keyword search, with the `hotel_no` `POST /v1/ota/rakuten` takes.
Rakuten lists hotels under Japanese names only, so an English name with
no match is looked up on Yahoo! Travel for its Japanese name and searched
again (`translated` says so). No candidate is free.

Request body (JSON):

- `name` (string; required; min length 1, max length 120): Hotel name as a guest would type it. Japanese and Korean sites list most hotels under their local-language name only.
- `city` (string; optional; default ; max length 80): City or area, used to rank candidates.
- `limit` (integer; optional; default 5; min 1, max 10): Most candidates returned.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)