joshu

Get a Google Shopping product

From Litescrape, through Joshu Data Bodega.

Part of Google Keyword Data shopping product.

Price
$0.000165 per call$0.17 per 1,000 calls

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • qstring, required

    Required search term from the shopping request that found the product. Google resolves the product page against it as well as the identifiers.

  • glstring, optional

    Two-letter country code used to localize results.

  • hlstring, optional

    Language code such as en, en-GB, or de.

  • prdsstring, optional

    Google product selector token from a previous response. Mutually exclusive with gpcid and its companion document IDs.

  • uulestring, optional

    Pre-encoded Google location token. Mutually exclusive with location.

  • gpcidstring, optional

    Product cluster ID from a shopping result. Required unless prds is supplied; follow litescrape_product_link for a ready-made request.

  • devicestring: desktop, tablet, mobile, optional

    Google device layout. Each device is served Google's real layout for it.

  • timeoutnumber, optional

    Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

  • locationstring, optional

    Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.

  • image_docidstring, optional

    Optional image document ID from the same shopping result; use with gpcid.

  • google_domainstring, optional

    Google domain used for the request.

  • headline_offer_docidstring, optional

    Optional headline offer document ID from the same shopping result; use with gpcid.

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "litescrape.google.shopping.product",
    "params": {
      "q": "coffee maker",
      "gpcid": "1234567890123456789",
      "image_docid": "1234567890123456789",
      "headline_offer_docid": "1234567890123456789"
    }
  }'