API reference · Google Shopping

google-shopping/bulk/listings

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APIAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDgoogle-shopping/bulk/listings

Input Schema

7 parameters · 4 required · 3 optional

Parameter	Type	Required	Description
`num`	string	Required	Number of results per page to scrape. · Options: 10, 20, 30, 40, 50, 100 · Default: "10" 1020304050100
`country`	string	Required	The country to search in. · Options: af, al, dz, as, ad, ao, ai, aq, ag, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bm, bt, bo, ba, bw, bv, br, io, bn, bg, bf, bi, kh, cm, ca, cv, ky, cf, td, cl, cn, cx, cc, co, km, cg, cd, ck, cr, ci, hr, cu, cy, cz, dk, dj, dm, do, ec, eg, sv, gq, er, ee, et, fk, fo, fj, fi, fr, gf, pf, tf, ga, gm, ge, de, gh, gi, gr, gl, gd, gp, gu, gt, gn, gw, gy, ht, hm, va, hn, hk, hu, is, in, id, ir, iq, ie, il, it, jm, jp, jo, kz, ke, ki, kp, kr, kw, kg, la, lv, lb, ls, lr, ly, li, lt, lu, mo, mk, mg, mw, my, mv, ml, mt, mh, mq, mr, mu, yt, mx, fm, md, mc, mn, ms, ma, mz, mm, na, nr, np, nl, an, nc, nz, ni, ne, ng, nu, nf, mp, no, om, pk, pw, ps, pa, pg, py, pe, ph, pn, pl, pt, pr, qa, re, ro, ru, rw, sh, kn, lc, pm, vc, ws, sm, st, sa, sn, rs, sc, sl, sg, sk, si, sb, so, za, gs, es, lk, sd, sr, sj, sz, se, ch, sy, tw, tj, tz, th, tl, tg, tk, to, tt, tn, tr, tm, tc, tv, ug, ua, ae, gb, us, um, uy, uz, vu, ve, vn, vg, vi, wf, eh, ye, zm, zw · Default: "us" afaldzasadaoaiaqagaramawauatazbsbhbdbbbybebzbjbmbtbobabwbvbriobnbgbfbikhcmcacvkycftdclcncxcccokmcgcdckcrcihrcucyczdkdjdmdoecegsvgqereeetfkfofjfifrgfpftfgagmgedeghgigrglgdgpgugtgngwgyhthmvahnhkhuisinidiriqieilitjmjpjokzkekikpkrkwkglalvlblslrlyliltlumomkmgmwmymvmlmtmhmqmrmuytmxfmmdmcmnmsmamzmmnanrnpnlanncnzninengnunfmpnoompkpwpspapgpypephpnplptprqarerorurwshknlcpmvcwssmstsasnrsscslsgsksisbsozagseslksdsrsjszsechsytwtjtzthtltgtktotttntrtmtctvuguaaegbusumuyuzvuvevnvgviwfehyezmzw
`language`	string	Required	The language to search in. · Options: af, ak, sq, am, ar, hy, az, eu, be, bem, bn, bh, xx-bork, bs, br, bg, km, ca, chr, ny, zh-cn, zh-tw, co, hr, cs, da, nl, xx-elmer, en, eo, et, ee, fo, tl, fi, fr, fy, gaa, gl, ka, de, el, gn, gu, xx-hacker, ht, ha, haw, iw, hi, hu, is, ig, id, ia, ga, it, ja, jw, kn, kk, rw, rn, xx-klingon, kg, ko, kri, ku, ckb, ky, lo, la, lv, ln, lt, loz, lg, ach, mk, mg, ms, ml, mt, mi, mr, mfe, mo, mn, sr-ME, ne, pcm, nso, no, nn, oc, or, om, ps, fa, xx-pirate, pl, pt, pt-br, pt-pt, pa, qu, ro, rm, nyn, ru, gd, sr, sh, st, tn, crs, sn, sd, si, sk, sl, so, es, es-419, su, sw, sv, tg, ta, tt, te, th, ti, to, lua, tum, tr, tk, tw, ug, uk, ur, uz, vi, cy, wo, xh, yi, yo, zu · Default: "en" afaksqamarhyazeubebembnbhxx-borkbsbrbgkmcachrnyzh-cnzh-twcohrcsdanlxx-elmereneoeteefotlfifrfygaaglkadeelgnguxx-hackerhthahawiwhihuisigidiagaitjajwknkkrwrnxx-klingonkgkokrikuckbkylolalvlnltlozlgachmkmgmsmlmtmimrmfemomnsr-MEnepcmnsononnocorompsfaxx-pirateplptpt-brpt-ptpaqurormnynrugdsrshsttncrssnsdsiskslsoeses-419suswsvtgtatttethtitoluatumtrtktwugukuruzvicywoxhyiyozu
`date_range`	string	Required	The date range to search for. · Options: anytime, qdr:h, qdr:d, qdr:w, qdr:m · Default: "anytime" anytimeqdr:hqdr:dqdr:wqdr:m
`query`	string	Optional	A single query to search for. If you need multiple queries, use the 'queries' field instead. · Default: "dogs"
`queries`	array	Optional	List of queries to search for in a single run. If provided, this takes priority over the single 'query' field.
`max_pages`	integer	Optional	The maximum number of pages to scrape. · Min: -9007199254740991 · Max: 9007199254740991 · Default: 1

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "google-shopping/bulk/listings",
  "num": "10",
  "query": "dogs",
  "country": "us",
  "language": "en",
  "max_pages": 1,
  "date_range": "anytime",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Google Shopping Listings