{"uid":"cap_umgYdvqf2MjgP_tjUnpZ0","slug":"rakuten-japan-product-scraper-44fc079f","name":"Rakuten Japan Product Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/rakuten?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pdpUrls":{"type":"array","default":[],"description":"Direct product URLs on item.rakuten.co.jp; each produces one detail record."},"genreIds":{"type":"array","default":[],"description":"Six-digit genre IDs to browse without a keyword, such as 560202 for smartphones."},"maxItems":{"type":"integer","default":1000,"minimum":1,"description":"Global product cap across all searches, genres, shops, and direct URLs."},"pagesPerShop":{"type":"integer","default":1,"maximum":150,"minimum":1,"description":"Maximum catalog pages for each shop, up to the public 150-page window."},"shopUrlCodes":{"type":"array","default":[],"description":"Shop codes from public shop URLs, such as rakutenmobile-store."},"pagesPerGenre":{"type":"integer","default":1,"maximum":150,"minimum":1,"description":"Maximum pages for each genre, up to the public 150-page window."},"searchQueries":{"type":"array","default":[],"description":"Search objects with keyword, optional genreId, sort (default, price-asc, price-desc, review), and pages (1-150)."},"includeDetails":{"type":"boolean","default":false,"description":"Open each product page to add description, breadcrumbs, availability, and full image list. Increases requests and runtime."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"name":null,"brand":null,"shopId":null,"itemCode":null,"subtitle":null,"shopUrlCode":null,"itemUniqueKey":null}],"product":"rakuten"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h_DZl4cLc0HANN9sA2_sV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured product data from Rakuten Japan (rakuten.co.jp) via search queries, genre browsing, shop catalogs, or direct product URLs","exampleAgentPrompt":"Search Rakuten Japan for 'wireless earbuds', sorted by price ascending, scrape up to 200 products across 3 pages, and include full product details like descriptions and images.","exampleUseCases":[{"title":"Competitor price research on Rakuten","prompt":"Pull all products from the Rakuten Japan shop 'rakutenmobile-store', up to 5 catalog pages and a max of 500 items, and include full product descriptions and availability so I can compare their pricing."},{"title":"Browse electronics by Rakuten genre","prompt":"Get me structured product listings for genre ID 560202 (smartphones) on Rakuten Japan, 3 pages deep, capped at 300 items, sorted by review score."},{"title":"Scrape specific Rakuten product pages","prompt":"Fetch full product details — including breadcrumbs, images, and availability — for these Rakuten product URLs: item.rakuten.co.jp/rakutenmobile-store/abc123 and item.rakuten.co.jp/rakutenmobile-store/def456."}],"resultDescription":"A JSON object with a count of matched products and an array of item records, each containing fields such as product URL, name, brand, shop ID, item code, subtitle, shop URL code, and item unique key. With includeDetails enabled, records also include description, breadcrumbs, availability status, and a full image list.","failureModes":["Empty result set if keyword returns no matches on Rakuten Japan (not charged)","Invalid genre ID returns no items","Shop URL code not found returns empty items array","Rate or page limits exceeded — pagesPerGenre or pagesPerShop capped at 150","maxItems cap reached before all sources are exhausted, truncating results","Network timeout on large includeDetails runs with many product pages"],"whenToPreferThis":"Use this endpoint when you need structured product data from Rakuten Japan specifically — including search results, genre-level catalogs, shop inventories, or individual product detail pages. It is ideal for price monitoring, competitive research, product catalog aggregation, or feeding downstream analysis pipelines focused on Japanese e-commerce. Prefer it over generic web scrapers when you need Rakuten-native fields like itemCode, shopUrlCode, and genreId already parsed and structured.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:44.892Z","isFirstParty":false,"canonicalSlug":"rakuten-japan-product-scraper-44fc079f"}