CommerceBrowser

Amazon JP

amazon.co.jp

Unverified Amazon Japan scraping provider for product discovery and detail pages.

Tier: 🥇 Gold
Reward: ₩300,000
Auth: Browser
Operations: 4
Working now: 0 contributors
Status: Open

Scope

Targets the unofficial amazon.co.jp web surface, so implementations must cope with session cookies, bot checks, and search result pagination rather than a public REST API. The usable surface here is centered on product search and product detail data for shopping workflows.

Expected operations

search-productsSearch productsreadDifficulty: hard

GET search results from amazon.co.jp for a keyword or ASIN-oriented query, with optional category and sort controls for shopping discovery.

Inputs

keywordstringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Search text used to find matching products

categorystringoptional

Narrow the result set to a storefront category or browse node

electronics

sortstringoptional

Sort order used by the marketplace listing

price-asc-rank

pagenumberoptional

Page number for result pagination

Outputs

asintitlepriceJpyprimeratingreviewCount

Acceptance

Returns a ranked list of products with asin, title, priceJpy, prime, rating, and reviewCount fields populated when the listing exposes them.
Respects category and sort filters without collapsing them into generic free-text search behavior.
Handles pagination explicitly and does not invent result counts when the page is truncated by marketplace limits or bot defenses.

No account auth required for this operation.

get-product-detailGet product detailreadDifficulty: hard

Fetch the canonical product page for a specific ASIN and extract the shopper-facing detail fields from amazon.co.jp.

Inputs

asinstringrequired
Amazon Standard Identification Number for the product page
B0C7XYZ123
offer_typestringoptional
Optional offer focus such as new, used, or featured offer
new

Outputs

asintitlepriceJpyprimeratingreviewCount

search-by-categorySearch by categoryreadDifficulty: hard

Search Amazon Japan within a browse category or department to support category-first shopping flows when keyword search is too broad.

Inputs

categorystringrequired
Category, department, or browse node to search within
home-kitchen
keywordstringoptional
Optional refinement keyword inside the selected category
water bottle
pagenumberoptional
Result page number
2

Outputs

asintitlepriceJpyprimeratingreviewCount

get-pricing-summaryGet pricing summaryreadDifficulty: hard

Inspect the visible offer summary for an ASIN and extract the displayed price and Prime availability from the product page or offer block.

Inputs

asinstringrequired
Product identifier whose offer summary should be inspected
B09N5Q1Y7M

Outputs

asinpriceJpyprimeratingreviewCount

Acceptance

Returns the best visible consumer price in yen when multiple offers are displayed.

Acceptance

Returns detail data for the requested ASIN and preserves the ASIN in the response.
Includes priceJpy and availability indicators only when the page actually exposes them, instead of fabricating missing fields.
Gracefully reports blocked, unavailable, or redirected product pages as domain-level failures rather than generic parse errors.

No account auth required for this operation.

Acceptance

Keeps the category constraint active so the returned products stay inside the chosen department.
Returns the same product fields as search-products so downstream consumers can reuse one schema.
Preserves pagination across multiple category pages without duplicating the first page.

No account auth required for this operation.

Does not confuse marketplace seller offers with the main listing price unless the page only exposes seller offers.

Keeps rating and reviewCount aligned with the same product page instead of mixing values across unrelated ASINs.

No account auth required for this operation.