{"uid":"cap_JMTLiG9ozXI2gs-cL-OUv","slug":"rakuten-product-scraper-x402-99550304","name":"Rakuten Product Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_x0EWO590lqeW8VX5bH6XA","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 via keyword search, genre browsing, shop catalogs, or direct product URLs, returning item details including name, brand, shop, and price.","exampleAgentPrompt":"Search Rakuten for 'wireless earphones' sorted by price ascending, grab up to 200 products across 3 pages, and include full product descriptions and images for each one.","exampleUseCases":[{"title":"Price comparison across Rakuten listings","prompt":"Search Rakuten for 'ワイヤレスイヤホン' sorted by price ascending, collect up to 500 products across 5 pages, and include availability so I can compare prices across sellers."},{"title":"Browsing a specific Rakuten genre","prompt":"Pull the top 300 products from Rakuten genre ID 560202 (smartphones) across 3 pages so I can analyze what's currently listed in that category."},{"title":"Extracting details from known Rakuten product URLs","prompt":"Fetch full product details — description, breadcrumbs, availability, and all images — for these 10 Rakuten product URLs I have from item.rakuten.co.jp."}],"resultDescription":"Returns a JSON object with a count of matched items and an array of product records, each containing the product URL, name, brand, shop ID, item code, subtitle, shop URL code, and item unique key. When includeDetails is true, also returns description, breadcrumbs, availability status, and full image list. The 'product' field confirms the source as 'rakuten'.","failureModes":["Empty result set (not charged) if keyword returns no matches or genre/shop has no products","Rate limiting or blocking by Rakuten resulting in partial or failed extraction","Invalid genre IDs or shop URL codes returning empty item arrays","maxItems cap reached before all pages are fetched, truncating results","Timeout on large requests with includeDetails enabled due to per-page HTTP requests","Malformed or inaccessible direct product URLs producing missing fields in response"],"whenToPreferThis":"Choose this endpoint when you need structured product data from Rakuten Japan specifically — by keyword, genre, shop, or direct URL — and want pay-per-call pricing where failed or empty runs are not charged. Prefer it over generic web scrapers when you need Rakuten-native fields like itemCode, shopUrlCode, and genreId, and over Rakuten's official API when you need full page content including descriptions, breadcrumbs, and image lists not exposed via the official API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:10.055Z","isFirstParty":false,"canonicalSlug":"rakuten-product-scraper-x402-99550304"}