DeliveryBrowser

InstaShop

instashop.com

UAE grocery discovery, cart drafting, substitution handling, checkout review, and delivery tracking for InstaShop.

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

Scope

Build a browser-based UAE grocery provider for InstaShop. This is an unofficial shopping surface, so it must compare stores, delivery slots, item availability, substitutions, loyalty offers, cart totals, checkout approval, picker updates, receipts, and refunds without claiming a public API.

Expected operations

search-groceriesSearch groceriesreadDifficulty: medium

Search stores and grocery items by address, category, brand, and delivery slot. Returns store and item cards that can be compared for pricing and availability.

Inputs

addressstringrequired

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.

Delivery address or area used to determine serviceability and nearby stores.

categorystringoptional

Optional grocery category such as produce, dairy, or household.

dairy

brandstringoptional

Optional brand filter for product matching.

Almarai

slotstringoptional

Desired delivery window or pickup slot.

today-evening

querystringoptional

Optional text query for a specific item or store.

milk

Outputs

storesitemsnamepricecurrencyavailabilityslotstore_nameproduct_url

Acceptance

Returns grocery store or item matches scoped to the supplied address.
Surfaces availability and slot information so the user can compare options.
Keeps store and item data distinguishable instead of flattening everything into one list.

No account auth required for this operation.

get-item-detailGet item detailreadDifficulty: medium

Open a grocery item page and extract stock, price, promotions, and any substitution options shown by the store.

Inputs

product_urlstringrequired
Canonical grocery item URL or item identifier from search results.
https://instashop.com/en-ae/products/milk-full-fat-1l

Outputs

namepricecurrencystockpromotionssubstitution_options

prepare-grocery-cartPrepare grocery cartwriteDifficulty: hard

Build a cart draft with quantities, replacement rules, notes, and the selected delivery slot before checkout confirmation.

Inputs

itemsarrayrequired
List of grocery item selections with quantities and optional substitutions.
[{"productUrl":"https://instashop.com/en-ae/products/milk-full-fat-1l","quantity":2}]
replacement_rulestringoptional
Replacement preference such as allow, call, or do-not-replace.
allow
notesstringoptional
Delivery or picker instructions for the order.
Leave at the concierge desk.
slotstringrequired
Selected delivery slot for the cart draft.
today-evening

Outputs

cart_statusitemsestimated_totalfeesslotreplacement_rule

review-checkoutReview checkoutreadDifficulty: medium

Review the final grocery total, fees, loyalty benefits, taxes, and payment method before the user approves submission.

Inputs

cart_idstringrequired
Prepared grocery cart or checkout session identifier.
gcart_9088

Outputs

subtotalfeesdiscountsloyalty_benefitstaxtotal

confirm-grocery-orderConfirm grocery orderwriteDifficulty: hard

Submit the grocery checkout only after the user explicitly approves the final total and substitutions policy.

Inputs

cart_idstringrequired
Prepared grocery cart identifier.
gcart_9088
approvalbooleanrequired
User confirmation that the shown checkout terms are acceptable.
true
payment_methodstringrequired
Final payment method used at checkout.
card

Outputs

order_idorder_statustotalcurrencyplaced_atreceipt_url

track-picking-and-refundsTrack picking and refundsreadDifficulty: medium

Track picker progress, substitutions, delivery status, refund state, and receipt availability for an existing grocery order.

Inputs

order_idstringrequired
Existing grocery order identifier.
gorder_55221

Outputs

picking_statussubstitutionsdelivery_statusrefund_statusreceipt_urltracking_number

Acceptance

Returns page-level item detail, not just the search card summary.
Includes substitution choices when the store exposes them.
Does not invent stock or promotion data that is not visible.

No account auth required for this operation.

Acceptance

Creates a draft cart without submitting the grocery order.
Keeps quantity, replacement rule, and slot visible for review.
Separates cart drafting from final approval.

Auth required for this operation.

Acceptance

Returns a full pre-submit cost breakdown rather than a single total only.
Shows loyalty or promotional benefits when available on the checkout page.
Uses the current cart state for totals and fees.

Auth required for this operation.

Acceptance

Does not place the order unless approval is explicitly true.
Returns an order identifier and receipt reference when successful.
Fails safely if required cart or payment information is missing.

Auth required for this operation.

Acceptance

Reports picker progress or substitutions when those states exist for the order.
Separates delivery, refund, and receipt data into distinct fields.
Works against the live order state rather than a stale cart snapshot.

Auth required for this operation.