Skip to content
Scrappa Get API key
Yahoo! Auctions Japan API 1 credit / request

Yahoo! Auctions Japan Search API Documentation

GET https://scrappa.co/api/yahoo-auctions-jp/search

Yahoo! Auctions Japan Search API Documentation Search public auction listings by keyword or category. Set status to sold for closed and sold prices. Filter by condition and price range, sort by price or newest and page through results. Each item has id, url, title, price in JPY, bids, watch count, condition, seller, end and start time as ISO 8601 with +09:00, and full-size image URLs. Flea-market rows are excluded. Ids feed the item endpoint unchanged. Each successful request costs 1 credit. A failed request is never billed.

Yahoo! Auctions Japan Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/yahoo-auctions-jp/search
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "data": {
        "page": 1,
        "items": [
            {
                "id": "v1251814298",
                "url": "https://auctions.yahoo.co.jp/jp/auction/v1251814298",
                "bids": 3,
                "price": 12000,
                "title": "Camera lens",
                "images": [
                    "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/1200x1200/lens.jpg"
                ],
                "seller": {
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

8 optional filters available.

query string Optional

Search keywords, for example camera. Required unless category is sent.

Example value coffee shops
category string Optional

Category id from search results. Up to five comma-separated ids.

Example value example
condition string Optional

Comma list of NEW, USED20, USED10 or USED5.

Example value example
min_price number Optional

Lowest price in JPY.

Example value 10
max_price number Optional

Highest price in JPY.

Example value 10
status string Optional

open (default) or sold.

Example value example
sort string Optional

relevance, price_asc, price_desc or newest.

Example value relevance
page integer Optional

Page number, 1 to 100. Defaults to 1.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data success
JSON Response
200 OK
{
    "data": {
        "page": 1,
        "items": [
            {
                "id": "v1251814298",
                "url": "https://auctions.yahoo.co.jp/jp/auction/v1251814298",
                "bids": 3,
                "price": 12000,
                "title": "Camera lens",
                "images": [
                    "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/1200x1200/lens.jpg"
                ],
                "seller": {
                    "name": "camera-shop",
                    "rating": 998,
                    "is_store": true
                },
                "status": "open",
                "currency": "JPY",
                "end_time": "2026-11-18T21:08:32+09:00",
                "condition": {
                    "id": "USED20",
                    "name": "Like new"
                },
                "sold_price": null,
                "original_price": 15000
            }
        ],
        "query": "camera",
        "total": 789000,
        "status": "open",
        "has_next": true,
        "per_page": 50
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A filter is missing or invalid. Upstream is not called and the request is not billed.

{
    "errors": {
        "condition": [
            "Use one or more of NEW, USED20, USED10, USED5."
        ]
    },
    "message": "The request validation failed"
}
503

Transport Unavailable

Upstream did not answer after several tries. The request is not billed.

{
    "error": {
        "code": "transport_unavailable",
        "message": "Yahoo! Auctions could not be reached right now. The request is not billed. Try again."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.