Skip to main content
POST
/
api
/
mercari
/
items
/
search
/mercari/items/search
curl --request POST \
  --url https://api.anysite.io/api/mercari/items/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 300,
  "timeout": 300,
  "category_id": 76,
  "status": [],
  "price_min": 1,
  "price_max": 1
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "name": "<string>",
    "@type": "@mercari_search_item",
    "price": 0,
    "currency": "JPY",
    "status": "<string>",
    "photo": "<string>",
    "thumbnail": "<string>",
    "condition_id": 123,
    "category_id": 123,
    "brand": {
      "id": 123,
      "name": "<string>",
      "@type": "@mercari_search_item_brand",
      "subname": "<string>"
    },
    "seller_id": 123,
    "shop_name": "<string>",
    "shipping_payer_id": 123,
    "shipping_method_id": 123,
    "item_type": "<string>",
    "is_no_price": false,
    "is_liked": false,
    "auction": {
      "@type": "@mercari_search_auction",
      "end_at": 123,
      "bid_count": 0,
      "highest_bid": 0,
      "initial_price": 0
    },
    "created_at": 123,
    "updated_at": 123
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.anysite.io/llms.txt

Use this file to discover all available pages before exploring further.

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:

"ps5 本体"

"iphone 15"

count
integer
required

Max number of results to return

Required range: 1 <= x <= 600
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
category_id
integer | null

Mercari category ID filter (e.g. 76 for game consoles)

Example:

76

sort
enum<string> | null

Sort field. Default: score (relevance)

Available options:
score,
created_time,
price,
num_likes
order
enum<string> | null

Sort order. Default: desc

Available options:
desc,
asc
status
enum<string>[] | null

Filter by item status. Empty/None = no filter

Available options:
on_sale,
sold_out,
trading
price_min
integer | null

Minimum price (JPY)

Required range: x >= 0
price_max
integer | null

Maximum price (JPY)

Required range: x >= 0

Response

Successful Response

id
string
required
url
string
required
name
string
required
@type
string
default:@mercari_search_item
price
integer
default:0
currency
string
default:JPY
status
string | null
photo
string | null
thumbnail
string | null
condition_id
integer | null
category_id
integer | null
brand
MercariSearchItemBrand · object
seller_id
integer | null
shop_name
string | null
shipping_payer_id
integer | null
shipping_method_id
integer | null
item_type
string | null
is_no_price
boolean
default:false
is_liked
boolean
default:false
auction
MercariSearchAuction · object
created_at
integer | null
updated_at
integer | null