DeliveryCredentials

Baemin

baemin.com

Unofficial Baemin provider for restaurant discovery, menu inspection, delivery quotes, and order tracking.

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

Scope

Targets the Baemin mobile or web surface rather than an official public API. Implement session-aware, anti-bot-resistant flows for nearby restaurant search, menu retrieval, delivery quote estimation, and live order tracking. Inputs are realistic location and order identifiers such as lat/lng, deliveryAddressId, restaurantId, and menu/item selections.

Expected operations

search-restaurants-nearbySearch nearby restaurantsreadDifficulty: hard

POST the location-based restaurant search used by Baemin to list stores around a coordinate pair and delivery address context, returning commercial availability and core store metadata.

Inputs

latnumberrequired

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.

Delivery or pickup latitude for the search center.

lngnumberrequired

Delivery or pickup longitude for the search center.

126.9780

delivery_address_idstringrequired

Saved address identifier used to resolve serviceability and delivery rules.

addr_kr_102938

sortstringoptional

Store ordering such as recommended, distance, or deliveryFee.

recommended

keywordstringoptional

Optional restaurant or cuisine keyword filter.

치킨

Outputs

restaurantsrestaurant_idrestaurant_namedistance_metersdelivery_feemin_order_amountis_open

Acceptance

Returns a ranked restaurant list for a valid coordinate and deliveryAddressId pair.
Each restaurant item includes restaurant_id, delivery_fee, min_order_amount, and open-state metadata.
Rejects missing or invalid address context instead of returning a generic empty list.

Auth required for this operation.

get-restaurant-menuGet restaurant menureadDifficulty: hard

Fetch the menu payload for a specific restaurantId, including sections, item variants, sold-out state, and option groups as shown in Baemin's menu view.

Inputs

restaurant_idstringrequired
Restaurant identifier obtained from search or deep link.
rest_557712
delivery_address_idstringrequired
Saved address identifier required to check menu availability and delivery constraints.
addr_kr_102938
latnumberoptional
Optional latitude used when the app requests location revalidation.
37.5665
lngnumberoptional
Optional longitude used when the app requests location revalidation.
126.9780

Outputs

menu_sectionssection_idsection_nameitemsitem_idprice

quote-delivery-orderQuote a delivery orderwriteDifficulty: hard

Simulate the Baemin checkout quote flow for a restaurant and selected menu items, returning estimated delivery fee, minimum order checks, and ETA-derived totals.

Inputs

restaurant_idstringrequired
Restaurant identifier for the quote target.
rest_557712
delivery_address_idstringrequired
Destination address identifier used for fee and serviceability calculation.
addr_kr_102938
itemsarrayrequired
Chosen menu items with quantities and option selections.
[{"menuItemId":"menu_991","quantity":2}]
payment_methodstringoptional
Optional payment type used by checkout rules.
card

Outputs

order_quote_iddelivery_feemin_order_amountsubtotaldiscount_amounteta_minutes

track-order-statusTrack order statusreadDifficulty: hard

Poll Baemin's order timeline endpoint for a live order_id to retrieve preparation, pickup, and courier progress in the same fields shown in the app.

Inputs

order_idstringrequired
Placed order identifier to follow through the delivery lifecycle.
ord_20240618_448812
delivery_address_idstringoptional
Optional address context when the app revalidates the route during tracking.
addr_kr_102938

Outputs

order_statusrestaurant_namecourier_namedriver_eta_minutescurrent_stepupdated_at

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

Acceptance

Returns structured menu_sections for a valid restaurantId tied to the current delivery address.
Includes item-level fields such as item_id, price, and sold_out rather than a flat string list.
Reflects menu changes per restaurant and does not reuse a generic schema across stores.

Auth required for this operation.

Acceptance

Produces a quote object with delivery_fee, subtotal, total_amount, and eta_minutes for the selected cart.
Fails when the basket is below min_order_amount or the restaurant is not serviceable to the address.
Returns a stable order_quote_id that can be reused by the downstream order creation flow.

Auth required for this operation.

Acceptance

Returns current_step and driver_eta_minutes for an active order_id rather than only a generic status string.
Shows the live progression from accepted to preparing to picked up to delivered when the order advances.
Rejects unknown order_id values with an authenticated not-found style response.

Auth required for this operation.