Seoul Seeker Catalog: Shopee integration overview
Operator: 서울시커 (Seoul Seeker), a Korean cross-border Shopee seller using the Korea Seller Center (KRSC) with 8 shops: SG, TW, TH, MY, VN, PH, BR and MX.
App type: Seller In-house System. This is an internal tool used only by 서울시커 (Seoul Seeker) for its own merchant account and shops. It is not offered to other sellers.
Contact: ola@seoulseeker.com · Privacy Policy: https://seoulseeker.com/privacy · Terms: https://seoulseeker.com/terms
What it does
Seoul Seeker Catalog keeps our product catalog in Google Sheets and keeps it in sync with our KRSC global products and shop listings:
- Product Catalog. Global products and variations, with name, description, category, brand, attributes, images, weight and dimensions, global price, costs and stock movements. We edit them in a spreadsheet, and the system sends the changes to KRSC.
- Shop Catalogs. One tab per shop, with each listing’s local name, description, images and price. Each field is either automatic (KRSC translation and conversion) or manual (our own value, protected).
- Margins. The expected margin per listing in each shop, based on Shopee’s fees, the published SLS shipping rates for the product’s chargeable weight, exchange rates and our costs.
- Publishing. New products are created as global products and published to the shops we choose.
Every change is checked, shown in a preview and confirmed by us before it is sent to Shopee.
How it connects to Shopee
- Authorization: the standard v2 shop authorization with our KRSC main account (merchant and shops). Access and refresh tokens are renewed automatically and stored only on our own systems.
- Requests: HTTPS, signed with HMAC-SHA256 as required. Rate limits are respected with backoff and bounded concurrency.
APIs used:
| Area | APIs |
|---|---|
| Auth / public | auth_partner, token/get, access_token/get, get_merchants_by_partner, get_shops_by_partner |
| Merchant | get_shop_list_by_merchant, get_merchant_warehouse_location_list |
| Shop | get_shop_info |
| Global product | get_global_item_list, get_global_item_info, get_global_model_list, get_global_item_id, get_category, get_brand_list, get_attribute_tree, add_global_item, update_global_item, init_tier_variation, update_tier_variation, update_global_model, update_price, update_stock, create_publish_task, get_publish_task_result, get_publishable_shop, set_sync_field |
| Product (shop level) | get_item_list, get_item_base_info, get_model_list, update_item, update_price, unlist_item |
| Media space | upload_image, init_video_upload, upload_video_part, complete_video_upload, get_video_upload_result |
| Order / payment (margins) | get_order_list, get_escrow_detail |
Use of Google data
Seoul Seeker Catalog uses Google sign-in and Google Sheets so we can edit our catalog in spreadsheets. It asks Google only for permission to see, edit, create and delete the specific spreadsheet files it creates (drive.file). It can’t access any other files. Google data is used only to read and write those spreadsheets, is never shared or sold, and follows the Google API Services User Data Policy, including its Limited Use requirements. Details are in our Privacy Policy.
Data handling
- Shopee data about our own shops, products and orders is used only to manage those shops. It is not sold, shared or used for any other purpose.
- No buyer personal data is stored. Order data is limited to amounts, fees, SKUs, quantities and parcel weights.
- Storage: a database on systems operated by 서울시커 (Seoul Seeker), readable only by the account that runs the system. Spreadsheets are in our own Google account, and the system’s Google access is limited to files it created.
- Secrets: partner keys, access tokens and refresh tokens are never published, committed to source control or shared.
- Deletion: if the integration is ended, tokens are revoked and stored Shopee data is deleted within 30 days.
Screenshots
- The Product Catalog sheet: global products and variations synced from KRSC, with sync status per row.
- A Shop Catalogs tab: one shop’s listings with local names, prices and expected margins.
- The preview shown before changes are sent to Shopee.