CommercePlatform secretMerged

Yahoo Shopping JP

shopping.yahoo.co.jp

Yahoo! Shopping product search provider using the official Web API.

Tier: 🥉 Bronze
Reward: ₩50,000
Auth: Platform secret
Operations: 4
Working now: 0 contributors
Status: Merged

Scope

Uses the official Yahoo Shopping Web API itemSearch endpoint to search product listings by keyword, category, JAN code, or store filters. The hunter must handle application ID authentication and the response structure under `hits` and top-level pagination fields.

Expected operations

search-products-by-keywordSearch products by keywordreadDifficulty: easy

Search Yahoo! Shopping items with an application ID and a text query, returning matching products in `hits`. Backed by the Yahoo Shopping Web API item search surface.

Inputs

appidstringrequired

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?

This provider has been merged. Browse other open bounties.

Claiming a bounty requires a GitHub sign-in.

Yahoo! Shopping application ID

querystringrequired

Search keyword

wireless headphones

resultsnumberoptional

Number of items to return

offsetnumberoptional

First result position

sortstringoptional

Sort order such as `-score`, `+price`, or `-review_count`

-score

Outputs

total_results_availabletotal_results_returnedfirst_results_positionhitsnamepricejan_code

Acceptance

Returns paging metadata together with at least one product hit for a valid query.
Each hit exposes product-level fields such as `name`, `price`, and `jan_code` when available.
Changing `sort` changes the order of the returned hits without altering the query itself.

Auth required for this operation.

search-products-by-categorySearch products by categoryreadDifficulty: easy

Search Yahoo! Shopping items within a category tree and return matching hits. Backed by the Yahoo Shopping Web API item search surface.

Inputs

appidstringrequired
Yahoo! Shopping application ID
demo-client-id
genre_category_idnumberrequired
Genre category ID
13457
resultsnumberoptional
Number of items to return
20
offsetnumberoptional
First result position
1

Outputs

hitsnamepricegenre_categorygenre_category_idseller

search-products-by-jan-codeSearch products by JAN codereadDifficulty: medium

Find the exact Yahoo! Shopping item that matches a JAN barcode and return the hit record. Backed by the Yahoo Shopping Web API item search surface.

Inputs

appidstringrequired
Yahoo! Shopping application ID
demo-client-id
jan_codestringrequired
JAN barcode number
4905524535815
resultsnumberoptional
Number of items to return
20

Outputs

hitsnamepricejan_codecodeseller_id

search-products-by-storeSearch products by storereadDifficulty: medium

Search listings from a specific store using seller_id and optional query filtering. Backed by the Yahoo Shopping Web API item search surface.

Inputs

appidstringrequired
Yahoo! Shopping application ID
demo-client-id
seller_idstringrequired
Store ID
y-store-001
querystringoptional
Optional keyword filter inside the store
camera
in_stockbooleanoptional
Limit to in-stock items
true

Outputs

hitsnamepricesellerseller_idin_stock

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

Acceptance

Returns only items belonging to the requested category tree.
Carries category metadata in or near the returned hit records.
Supports paging through category-constrained results.

Auth required for this operation.

Acceptance

Returns the item associated with the supplied JAN barcode when it exists.
Preserves the barcode in the response so callers can confirm the match.
Does not require a category ID when the JAN code is provided.

Auth required for this operation.

Acceptance

Returns products from the requested seller rather than a marketplace-wide search.
Shows seller identity fields so the source store can be verified.
Allows an in-stock filter without breaking the seller constraint.

Auth required for this operation.