CommerceCredentials

SSG.com

ssg.com

Unofficial SSG.com provider for product search, product detail, order history, and shipment tracking.

Tier: 🥈 Silver
Reward: ₩150,000
Auth: Credentials
Operations: 4
Working now: 0 contributors
Status: Open

Scope

Targets SSG.com's authenticated commerce surface rather than a public API. The provider needs to survive session handling, search filtering, variant selection, and post-order lookup while being transparent that it is scraping or reverse engineering the private web surface. Inputs should use real shopping filters and identifiers such as keyword, category, brand, sort, product_id, size, color, and order_id.

Expected operations

search-productsSearch productsreadDifficulty: medium

Query the SSG search surface with keyword and merchandising filters to return product cards with prices, review counts, and stock state.

Inputs

keywordstringrequired

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 keyword for the catalog.

categorystringoptional

Optional category filter.

sports

brandstringoptional

Optional brand filter.

nike

sortstringoptional

Sort order such as popularity, low price, or review count.

review

Outputs

productsproduct_idbrandpricereview_countsold_outpromotion_text

Acceptance

Returns a product array with product_id, brand, price, and sold_out fields for the search keyword.
Applies the requested filters or sort when provided.
Includes review_count or promotion_text for commerce cards rather than bare titles.

No account auth required for this operation.

get-product-detailGet product detailreadDifficulty: medium

Fetch the full SSG product page data for a given product_id, including variants, delivery notes, and review summary fields exposed in the private storefront.

Inputs

product_idstringrequired
Product identifier from search or a product link.
ssg_99112233

Outputs

product_idbrandpricesizecolorreview_count

list-ordersList ordersreadDifficulty: hard

Retrieve the authenticated customer's SSG order history with paging and date filters, matching the order center seen after login.

Inputs

pagenumberoptional
1-based page number for order history results.
1
sizenumberoptional
Maximum number of orders to return per page.
20
from_datedateoptional
Optional lower bound for order date filtering.
2024-05-01
to_datedateoptional
Optional upper bound for order date filtering.
2024-06-30

Outputs

ordersorder_idorder_statusorder_totalordered_atdelivery_status

track-shipmentTrack shipmentreadDifficulty: hard

Look up courier progress for a specific SSG order_id to surface parcel milestones, current carrier state, and the latest update time.

Inputs

order_idstringrequired
Order identifier to inspect for shipment progress.
ssg_ord_440022
tracking_numberstringoptional
Optional parcel tracking number returned by the merchant or carrier.
364821098712

Outputs

order_idcarrier_nametracking_numbershipment_statuscurrent_steplast_updated_at

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

Acceptance

Returns size and color availability together with price and sold_out for the requested product_id.
Includes review_count and delivery_fee when those fields are shown on the product page.
Rejects invalid product_id values rather than inventing placeholder data.

No account auth required for this operation.

Acceptance

Returns only authenticated orders with order_id and order_status in the response.
Respects page, size, and date filters over the order center dataset.
Provides delivery_status for shipped or completed orders when available.

Auth required for this operation.

Acceptance

Returns shipment_status and current_step for the requested order_id.
Uses tracking_number if present and still works when only order_id is provided.
Does not return shipment details outside the authenticated account scope.

Auth required for this operation.