Google Shopping Search API

Search Google Shopping for products, with each one's price, merchant and rating.

GET | POST /v1/google-shopping/search

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/google-shopping/search?query=running+shoes&region=US" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

Parameter	Type	Notes
`cursor`	string	Next page: pass the previous result's `cursor` alone.
`facets`	string \| object list	One value from a result's `facets` (include=facets), e.g. facets=Brand:<value>. Google applies one at a time.
`include`	string list	`facets` — the filter rail Google shows beside the results, on the same page (no extra request).
`priceMax`	number ≥ 0	Highest price, in the market's currency (decimal major units).
`priceMin`	number ≥ 0	Lowest price, in the market's currency (decimal major units).
`query`	string	Keywords to search for.
`region`	enum	The market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency. `US` `GB` `CA` `AU`

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns SearchResult in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "marketplace": "google-shopping",
    "query": "running shoes",
    "page": {"index": 1, "size": 54},
    "items": [
      {
        "marketplace": "google-shopping",
        "id": "14699928440903523478",
        "url": "https://www.google.com/search?ibp=oshop&q=Hoka+Men%27s+Clifton+11&prds=catalogid%3A5939486839279040471%2Cgpcid%3A14699928440903523478%2CheadlineOfferDocid%3A905…",
        "title": "Hoka Men's Clifton 11",
        "price": {"currency": "USD", "amount": 154.95},
        "brand": "Hoka One One",
        "seller": {"name": "Zappos.com", "logoUrl": "data:image/png;base64,iVBORw0KGgoAAAANSU…"},
        "rating": {"average": 4.484, "count": 412},
        "delivery": {"estimate": "Free delivery by Mon", "free": true},
        "returnsPolicy": "Free 365-day returns",
        "badges": [],
        "promotions": [],
        "attributes": [],
        "groupId": "14699928440903523478",
        "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRqYH_zOknkUmPHPQooSsPMYiYGJMv-jev2oHa3IYWYR3S1ZdTQiAb3gLS_dNid6BzrdE1cSbjGZFbQVF2Nkj2ST_R5sfE4Tw",
        "ext": {
          "summary": "Hoka Men's Clifton 11. Current Price: $154.95. Zappos.com & more. Free delivery by Mon. Free 365-day returns. Rated 4.5 out of 5. 412 reviews.",
          "moreStores": true,
          "shelf": "Beginner Running Shoes",
          "catalogId": "5939486839279040471",
          "productId": "13107188378090301883",
          "offerId": "9057001329748764354",
          "imageId": "8494207511608046187"
        },
        "offers": [
          {
            "seller": {
              "name": "Peter Glenn Ski & Sports",
              "logoUrl": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn%3AANd9GcTgj6MTV2jVPsWTKNdSwoPkVupNia0bUqnfBm8PYegVt-ywkuVH1n9-VCekAnK6c1rBK6Eho-3SEcUhcTEOMxTwKsE_qF3XMchpt…"
            },
            "price": {"currency": "USD", "amount": 155},
            "delivery": {"estimate": "Free delivery by Tue", "free": true},
            "ext": {"offerId": "18164253511807076099", "shelf": "All products"}
          }
        ]
      },
      {
        "marketplace": "google-shopping",
        "id": "1522057692120988320",
        "url": "https://www.google.com/search?ibp=oshop&q=New+Balance+Women%27s+Fresh+Foam+X+Kaiha+Road+V2+Running+Shoes&prds=catalogid%3A2224207068186773069%2Cgpcid%3A15220576…",
        "title": "New Balance Women's Fresh Foam X Kaiha Road V2 Running Shoes",
        "price": {"currency": "USD", "amount": 104.99},
        "brand": "New Balance",
        "seller": {"name": "New Balance", "logoUrl": "data:image/png;base64,iVBORw0KGgoAAAANSU…"},
        "rating": {"average": 5, "count": 166},
        "returnsPolicy": "45-day returns",
        "badges": [],
        "promotions": [],
        "attributes": [],
        "groupId": "1522057692120988320",
        "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSSyE2K1PfUS8yxgpTwvT2vlaiCaO84uGQNRSOkkjF_LCLn3s7bRKN1RMRFX2rwek5QYVUaeWIIL4W6zE7k1A266nu7dx6K",
        "ext": {
          "summary": "New Balance Women's Fresh Foam X Kaiha Road V2 Running Shoes. Current Price: $104.99. New Balance & more. 45-day returns. Rated 5.0 out of 5. 166 reviews.",
          "moreStores": true,
          "shelf": "Beginner Running Shoes",
          "catalogId": "2224207068186773069",
          "productId": "16229217600571913203",
          "offerId": "8468470629989173210",
          "imageId": "1190089453230405951"
        }
      }
    ],
    "cursor": "tRlUbjVXzLQ2mckO_0hUg_oRXAX71LylzGzTA4ov5NQm-NnRYdL9Cydv_yTsWQvUY7ouiehwkp5AzTrHVcRpPcxjhMZBDfWSR6cMUeo1EiZf7Lnj_fUyC3sfVIdge_nN-YWBk_4YkMM"
  }
}

Errors

Status	Code	Meaning
400	`INVALID_CURSOR`	The `cursor` is not one this operation returned. Start again without it.
400	`INVALID_PARAMS`	A parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401	`UNAUTHORIZED`	The `x-api-key` header is missing, or the key is revoked or unknown.
402	`INSUFFICIENT_BALANCE`	The balance does not cover this call. Top up in the dashboard.
429	`MARKETPLACE_SATURATED`	Too many concurrent calls. Retry after the `Retry-After` seconds.
502	`UPSTREAM_ERROR`	The engine answered with something unusable. Retry with backoff.
503	`SERVICE_UNAVAILABLE`	A temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.

Notes

include=facets adds the filter rail Google shows beside the results, at no extra cost. Pass one of its values as facets to filter.
priceMin and priceMax are in the market's currency, in decimal major units.

Search