Apinoa Docs

Product

Get a product's page from Google Shopping: its details, specs and the merchants selling it.

View raw .mdx
GET | POST /v1/google-shopping/product

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/product?id=14699928440903523478&region=US" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

ParameterTypeRequiredNotes
idstringThe product, as a search item's id carries it.
includestringoffers · offers:5 · offers:all — every merchant selling the product, 10 per request after the 3 the page shows. Depth counts requests and each is charged; all walks to the end, capped at 20.
regionenumThe market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency. US GB CA AU
urlstringA Google Shopping product link instead of id (the url a search item carries).

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

Response

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

{
  "success": true,
  "data": {
    "marketplace": "google-shopping",
    "id": "14699928440903523478",
    "url": "https://www.google.com/search?ibp=oshop&q=Hoka+Men%27s+Clifton+11&prds…",
    "title": "Hoka Men's Clifton 11",
    "price": {"currency": "USD", "amount": 154.95},
    "brand": "Hoka One One",
    "rating": {
      "average": 4.72,
      "count": 445,
      "distribution": {"1": 3, "2": 1, "3": 4, "4": 11, "5": 84},
      "starCounts": {"1": 11, "2": 2, "3": 14, "4": 46, "5": 372}
    },
    "seller": {
      "id": "15872",
      "name": "Zappos.com",
      "logoUrl": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.zappos.co…",
      "rating": {"average": 4.8}
    },
    "badges": [],
    "promotions": [],
    "attributes": [{"name": "Size", "value": "Size 5, Size 5½, Size 6, Size 6½, Size 7, Size 7½, Size 8, Size 8½, Si…"}],
    "groupId": "14699928440903523478",
    "description": "The Men's HOKA Clifton 11 Running Shoe is a lightweight shoe for runni…",
    "features": [],
    "media": {"images": ["https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSwvRhrsajonYuP…"], "videos": []},
    "category": [],
    "options": [
      {
        "id": "Color",
        "name": "Color",
        "values": [
          {
            "id": "EigiBWNvbG9yKh9hbnRpcXVlIG9saXZlIC8gcml2ZXIgcm9jayBncmV5",
            "name": "Antique Olive / River Rock Grey",
            "imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSTx7SmeSRrNlMr…"
          }
        ]
      }
    ],
    "variants": [],
    "offers": [
      {
        "seller": {
          "id": "15872",
          "name": "Zappos.com",
          "logoUrl": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.zappos.co…",
          "rating": {"average": 4.8}
        },
        "price": {"currency": "USD", "amount": 154.95},
        "inStock": true,
        "status": "In stock online",
        "delivery": {"estimate": "Free delivery between Sat - Mon", "free": true},
        "ext": {
          "title": "HOKA Clifton 11 Men's Running Shoes Galactic Grey/Stellar Grey : 10 D…",
          "returns": "Free 365-day returns",
          "offerId": "6449949928584705062",
          "badges": ["Best price"],
          "url": "https://www.zappos.com/product/10047344/color/1107224?utm_medium=fpa&u…"
        }
      }
    ],
    "reviewSummary": "Users praise these shoes for their exceptional comfort, lightweight fe…",
    "reviewAspects": [{"name": "Comfort", "positive": 130, "negative": 7}],
    "boxContents": [],
    "reviews": [
      {
        "id": "PR_3P_f5ad9bac86f8a072818655448a2d2a25",
        "author": "Joshua W",
        "authorAvatarUrl": "https://lh3.googleusercontent.com/shsm/AGYqVK3f_a0qsNdewufUaN9jNMjhBA2…",
        "rating": 3,
        "title": "Looking for some help",
        "body": "The shoes feel great.. the very light and comfortable under the foot….…",
        "images": [],
        "syndicatedFrom": "ewavedemo.com",
        "ext": {"dateText": "2 months ago"}
      }
    ],
    "ext": {
      "aspectDetails": [
        {
          "name": "Comfort",
          "positive": "Comfortable",
          "negative": "Uncomfortable",
          "summary": "Users find the shoes to be very comfortable, with many experiencing a…"
        }
      ],
      "reviewImageCount": 39,
      "insights": [
        {
          "topic": "Comfort (Midsole, Cushioning)",
          "cards": [
            {
              "kind": "review",
              "source": "Tom's Guide",
              "title": "I ran 35 miles in the Hoka Clifton 11 and it’s a comfortable daily tra…",
              "url": "https://www.tomsguide.com/wellness/running/hoka-clifton-11-review",
              "favicon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.tomsguide…",
              "pros": ["Comfortable upper"],
              "more": "4 more pros and cons",
              "dateText": "2mo"
            }
          ]
        }
      ],
      "discussions": [
        {
          "title": "Have you upgraded to the new HOKA Clifton 11 yet? We've been testing o…",
          "url": "https://www.facebook.com/RoadRunnerSports/posts/have-you-upgraded-to-t…",
          "source": "Facebook",
          "favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.facebook.…",
          "dateText": "3 months ago",
          "answers": [
            {
              "text": "A supercritical ProGlide+ midsole brings it in line with its daily tra…",
              "url": "https://www.facebook.com/RoadRunnerSports/posts/have-you-upgraded-to-t…"
            }
          ]
        }
      ],
      "relatedProducts": [
        {
          "id": "11647404279960666288",
          "url": "https://www.google.com/search?ibp=oshop&q=HOKA+Men%27s+Rincon+4&prds=c…",
          "title": "HOKA Men's Rincon 4",
          "price": {"currency": "USD", "amount": 80},
          "listPrice": {"currency": "USD", "amount": 125},
          "seller": "JD Sports",
          "rating": {"average": 4.4},
          "reviewCountText": "1k+",
          "badges": ["36% OFF"],
          "imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSGvxJsiQ4WzXyw…",
          "shelf": "More options"
        }
      ],
      "typicalPrice": {"min": {"currency": "USD", "amount": 155}, "max": {"currency": "USD", "amount": 165}},
      "typicalPriceText": "Typically $155 to $165",
      "priceHistory": [
        {
          "seller": "Zappos.com",
          "points": [{"date": "2026-08-13", "price": {"currency": "USD", "amount": 155}}]
        }
      ]
    }
  }
}

Errors

StatusCodeMeaning
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
404PRODUCT_NOT_FOUNDGoogle Shopping has no such product. The message names the id.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

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

Pricing

Price $0.0012 per call, plus $0.0012 for each extra call it makes — at most 20 more, so $0.0252 in total. List price; the rate steps down above 1,000 calls a day.

Notes

  • Pass a search item's id, or its url.
  • include=offers adds every merchant selling the product: 10 per request after the 3 the page shows, one unit per request (offers:5 for five requests, offers:all up to 20).

On this page