Send us your product feed
Listing your prices on ThukThuk is free during the pilot. Send the feed you already have for Google Shopping. We read it on your schedule (at most hourly) and every run has a report we share with you: which lines passed, which did not, and why.
Formats
- Google Merchant Center: XML (RSS 2.0 or Atom with
g:fields) or TSV, as in Google's product data specification. - CSV: a header line with the column names below (UTF-8).
- JSON: an array of objects, or
{"items": [...]}.
Files are UTF-8, may be gzipped, and come from an HTTPS URL. Please support ETag or Last-Modified, so an unchanged feed is not downloaded again.
Verified domains
Every product link must be on one of your verified domains (by a DNS TXT record or a file on your site). Links elsewhere are rejected.
Required
id | Your SKU, up to 50 characters, unique in the feed.LIT-990P-2T |
|---|---|
title | Product name, up to 150 characters: brand, model, capacity or size.Samsung 990 PRO 2TB NVMe M.2 |
link | The product page, https, on one of your verified domains.https://shop.example/p/990-pro-2tb |
price | Price including VAT, in baht.6,490.00 THB |
availability | in_stock, out_of_stock, few_left, preorder or backorder.in_stock |
Strongly recommended
A GTIN, or brand and MPN, lets us match your offers to the right product at once; the rest wait for a person.
gtin | EAN/UPC barcode (8, 12, 13 or 14 digits): the surest way to match.2099990000013 |
|---|---|
brand | Brand.Samsung |
mpn | The maker's part number: matches when there is no barcode.MZ-V9P2T0BW |
shipping | Delivery in Thailand for this item; above your shop's delivery rule, the difference counts as a bulky surcharge.TH::Standard:300 THB |
Also read
sale_price | A sale price, used instead of price within its dates.5,990 THB |
|---|---|
sale_price_effective_date | When the sale price applies (ISO 8601).2026-11-01T00:00+07:00/2026-11-30T23:59+07:00 |
availability_date | When preorders or backorders ship.2026-11-20 |
ships_in_days | Or the days until it ships.3 |
condition | new (the default), refurbished or used.new |
warranty | official (Thai distributor), shop, or none, with the months.official 60 |
warranty_months | Warranty months, if not in warranty.24 |
multipack | Items in a pack: packs never match the single item.2 |
is_bundle | yes for a bundle of different items.no |
image_link | Product image, https.https://shop.example/img/990.jpg |
google_product_category | Google's category: helps us place new products.Electronics > Computer Components |
product_type | Your own category.SSD > NVMe |
identifier_exists | no for products without a barcode.no |
affiliate_link | Affiliate network feeds only (Involve Asia, Shopee).https://invol.co/… |
Lines we reject
missing_id: no idbad_id: id longer than 50 characters or with control charactersmissing_title: no titlemissing_link: no linkbad_link: link is not an http(s) URLforeign_domain: link is not on one of the shop's verified domainsmissing_price: no pricebad_price: price is not a number like 6490, 6,490.00 or 6490 THBwrong_currency: price is not in THBprice_out_of_range: price is zero or above ฿10,000,000missing_availability: no availabilitybad_availability: availability is not in_stock, out_of_stock, preorder, backorder or few_leftbad_condition: condition is not new, refurbished or used
Values we drop (the line still counts)
duplicate_id: the same id came again; the last line countslong_title: title cut to 150 charactersbad_gtin: GTIN check digit is wrong or it is not 8, 12, 13 or 14 digits; GTIN droppedbad_mpn: MPN longer than 70 characters; droppedbad_sale_price: sale price or its dates unreadable; regular price usedbad_shipping: shipping entry unreadable; ignoredshipping_below_rule: shipping below the shop's delivery rule; the rule is usedbad_warranty: warranty unreadable; shown as not statedships_in_guessed: preorder or backorder without a date; shown as ships in 14 daysbad_multipack: multipack is not a whole number; ignoredbad_image_link: image link is not an http(s) URL; droppedbad_affiliate_link: affiliate link not on the network's domain; dropped
Unusual prices
A price more than 40% away from the one we last showed, or below half the other shops' median, is held back until the next run sends it again; then it shows. Offers missing from two runs in a row show as out of stock.
CSV example
id,title,link,price,availability,brand,gtin,mpn,shipping
SKU-1,Samsung 990 PRO 2TB NVMe M.2,https://shop.example/p/sku-1,"6,490.00 THB",in_stock,Samsung,2099990000013,MZ-V9P2T0BW,TH::Standard:0 THB
Contact: shops@thukthuk.io