Skip to main content
POST
/
api
/
rakuten
/
items
/
search
/rakuten/items/search
curl --request POST \
  --url https://api.anysite.io/api/rakuten/items/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "sort": "relevancy",
  "price_min": 1,
  "price_max": 1,
  "genre_id": 564500
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@rakuten_search_item",
    "item_code": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "image": "<string>",
    "price": 123,
    "price_max": 123,
    "currency": "JPY",
    "point": 123,
    "is_free_shipping": false,
    "is_sold_out": false,
    "rating": 123,
    "review_count": 123,
    "category_id": 123,
    "category": "<string>",
    "genre_breadcrumbs": [],
    "shop": {
      "@type": "@rakuten_search_item_shop",
      "id": 123,
      "name": "<string>",
      "alias": "<string>"
    },
    "is_sponsored": false
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required

Search keyword

Minimum string length: 1
Examples:

"iphone"

"コーヒー 豆"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
sort
enum<string>
default:relevancy

Sort order. Default: relevancy

Available options:
relevancy,
price_low_to_high,
price_high_to_low,
newest,
review_count,
review_score
condition
enum<string> | null

Filter by item condition (new or used)

Available options:
new,
used
price_min
integer | null

Minimum price (JPY)

Required range: x >= 0
price_max
integer | null

Maximum price (JPY)

Required range: x >= 0
genre_id
integer | null

Rakuten genre/category ID filter

Example:

564500

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@rakuten_search_item
item_code
string | null
title
string | null
subtitle
string | null
image
string | null
price
number | null
price_max
number | null
currency
string
default:JPY
point
integer | null
is_free_shipping
boolean
default:false
is_sold_out
boolean
default:false
rating
number | null
review_count
integer | null
category_id
integer | null
category
string | null
genre_breadcrumbs
string[]
shop
RakutenSearchItemShop · object
is_sponsored
boolean
default:false