What’s a GID in Google Shopping API?
in
The GID is a special global identifier assigned to a product entity listed on the Google Shopping marketplace. This ID serves as a link between product entities and their associated reviews and ratings data. Without a GID, Google doesn’t provide detailed rating-related information for a product.
How is GID different from product ID? The product ID is a unique identifier assigned by the manufacturer to each specific product. If multiple retailers sell the same product, they will all share the same product ID. The GID, on the other hand, is specifically designed to connect a particular product to relevant reviews and ratings on Google Shopping.
Where to find the GID of a product?
In DataForSEO Google Shopping API, once you set a task to the Google Shopping Products endpoint, you will find the products’ GIDs in the response of the GET endpoint:
Example: “gid”: “9961958114952839788”
Using GID in the Google Shopping API endpoints
1 The GID is required for setting a task for the Google Shopping Reviews:
POST: https://api.dataforseo.com/v3/merchant/google/reviews/task_post
Request example:
[
{
"language_code": "en",
"location_code": 2840,
"gid": "9961958114952839788"
}
]
In the response of the respective GET endpoint, you will receive detailed review and rating data for a product.
Response example:
{
"version": "0.1.20251015",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0605 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "10171648-1535-0415-0000-befec749255e",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0340 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"merchant",
"google",
"reviews",
"task_get",
"advanced",
"10171648-1535-0415-0000-befec749255e"
],
"data": {
"se_type": "reviews",
"api": "merchant",
"function": "reviews",
"se": "google",
"language_code": "en",
"location_code": 2840,
"gid": "9961958114952839788",
"device": "desktop",
"os": "windows"
},
"result": [
{
"product_id": "gid:9961958114952839788",
"type": "reviews",
"se_domain": "google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://google.com/search?ibp=oshop&q=gid%3A9961958114952839788&gl=US&hl=en&udm=28&prds=gpcid:9961958114952839788,rds:PC_9961958114952839788%7CPROD_PC_9961958114952839788,pvt:hg,pvo:3&&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"url": null,
"datetime": "2025-10-17 13:48:21 +00:00",
"spell": null,
"title": "Apple iPhone 17 Pro",
"image_url": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQZ2PhVs9gu2b6Tv8kzfOelRRB7ZueDWEbB8ItZk6rMb0_s9AXAR1IgAFa7zDrcmD1Ti6LZsxgvLzWZHkSdwbvww7--SsrSS5rQalUuEltbEvsEAPN6wjH-I1I",
"rating": null,
"rating_groups": null,
"top_keywords": null,
"reviews_count": 0,
"item_types": [
"google_shopping_review_item"
],
"items_count": 100,
"items": [
{
"type": "google_shopping_review_item",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"images": null,
"title": "Great phone",
"url": null,
"review_text": "I have just updated from the iPhone X to the iPhone 17 Pro. I love the colour, navy blue . I have noticed such a big difference between my phones. It has been like going from medieval to modern times. I was worried about the size as I have very small hands. Although a little bigger it is really comfortable to hold. The phone is lightning fast. It was extremely easy to transfer the data from the old phone and pair with my Apple Watch. So far I have taken a few photos of my cat and experimented with different depths of field. The selfie camera is a huge improvement with lovely crisp images. I was wanting a phone that could take good stills and video as finding carrying a camera all day can really hurt you back. Although I have not had this phone long I am hugely impressed by the quality of the photos. I have tried a few video shots both outside and indoor in low light and they do not disappoint. The images are clear and stable. As someone who is keen on photography and taking holiday videos I think this phone will be awesome and so much easier to carry. All my apps transferred so easily. I bought the phone from John Lewis and collected the next day from my local Waitrose a brilliant and easy transaction",
"provided_by": "johnlewis.com",
"author": "Velvet",
"publication_date": "2025-09-26 13:48:21 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "google_shopping_review_item",
"rank_group": 100,
"rank_absolute": 100,
"position": "left",
"images": null,
"title": "I think I made a mistake by changing over to Verizon.",
"url": null,
"review_text": "Purchase a phone online with the assistance of a customer service representative. Changeover my number then there was difficulty. The customer service representative was supposed to call me back, he never did. So I order the phone myself which I thought was the same phone. When I received my new phone it was the wrong phone. I called customer service and got a return label. Took my phone to three different stores and they all made excuses on why can’t exchange my phone. Called customer service again and now I have to wait three weeks for another phone.",
"provided_by": "vzw.com",
"author": null,
"publication_date": "2025-09-26 13:48:21 +00:00",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
}
}
]
}
]
}
]
}
2 You can specify gid to set a task to the Google Shopping Product Info and Google Shopping Sellers endpoints, instead of product_id or data_docid.
Example request to the Google Shopping Product Info endpoint:
POST: https://api.dataforseo.com/v3/merchant/google/product_info/task_post
[
{
"language_code": "en",
"location_code": 2840,
"gid": "9961958114952839788"
}
]
Response example:
{
"version": "0.1.20251015",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0724 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "10161905-1535-0455-0000-6436c40ec2ab",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0249 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"merchant",
"google",
"product_info",
"task_get",
"advanced",
"110161905-1535-0455-0000-6436c40ec2ab"
],
"data": {
"se_type": "product_info",
"api": "merchant",
"function": "product_info",
"se": "google",
"language_code": "en",
"location_code": 2840,
"gid": "9961958114952839788",
"device": "desktop",
"os": "windows"
},
"result": [
{
"product_id": "gid:9961958114952839788",
"type": "product_info",
"se_domain": "google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://google.com/search?ibp=oshop&q=gid%3A9961958114952839788&gl=US&hl=en&udm=28&prds=gpcid:9961958114952839788,rds:PC_9961958114952839788%7CPROD_PC_9961958114952839788,pvt:hg,pvo:3&&gws_rd=cr&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"datetime": "2025-10-16 16:05:47 +00:00",
"item_types": [
"product_info_element"
],
"items_count": 1,
"items": [
{
"type": "product_info_element",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"product_id": null,
"title": "Apple iPhone 17 Pro",
"description": "The Apple iPhone 17 Pro combines elegant design with powerful performance to deliver an immersive smartphone experience. With a 6.3-inch OLED display featuring Super Retina XDR technology, enjoy vibrant colors and clarity whether streaming videos or browsing photos. Engineered with a robust A19 Pro chip and dual-SIM capability using e-SIM technology, this smartphone is built for speed and convenience. Battery performance is notable, with a durable lithium-ion battery that supports fast charging and wireless charging standards like Qi2, ensuring you stay powered throughout the day. Photography and videography reach new heights with a camera system comprising three rear cameras and an impressive front camera, enabling exceptional shots in any lighting condition. With features such as 4K Dolby Vision video recording and Smart HDR, capturing stunning visuals is easier. Enhanced connectivity is provided through 5G technology and various wireless interfaces including Wi-Fi 7 and Bluetooth 6.0, ensuring reliable performance for all smart device users. The iPhone 17 Pro is not just a smartphone; it’s a tool for creativity and connectivity.",
"url": null,
"images": [
"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcQnQH5HFkqHbnUUIrHDCnXBV7i5aFN2O5GNwCZpuXSY5Z2rk5MkjL397mxyw4aWbFVrCu-TjOKyQCZyYYFX_wB2B3cFjtc1eWLvesPqPr6GVCXwtx0_b1V2SDA",
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQs2PizcCFunGAlOMQUUA7mlWVjrcIvR-ATHXKuG6plSazuis9wXYj_TM4C1HBP_r2Tr88JENeNWC_BQlztODHCZjtULM_3rcuuBPBXISiaiigDsp9QZizNgoY",
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcT4XWPHNiGQj7ZCm5S218cHk_JzyoSVpIdsXPkhvo8lD6OYdKDDiWFk5pbbj1AmfwfjYItbA9AUP_ICD5to-yJB5Vnl7j9OA7I3UC5s5ebvd-043w2r_zuP3A",
"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcS4Yfe801y_ul4WP0XL--YRL-dcWaH7JcAWa75gTZOmXlYp_B4S8-1bJzM1s203XySq6Qte9f4YZNeerE-rFoq4leh2YTaxZoGnnvChcNnTp_YdKyCvzWjP",
"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcS6oS2n88jacA9R2n5vhzY19zQQeLiO8Jec1yeU9uzoBwCPQ6gM1c8wHPciqWyl2HHCTlluNSAW-zQTsSjNtBI3IwXZ500JgfDMIPMmyqk",
"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcRiVWBAj5CuzjNQeZl7l9YTw0pa5CFJIQa2QfhY8Pf-6v0Yo9WNvyh2MiZVDBqjSVom9H0K2mUsC6ljpPkCD0zzlECwG_oruvKRe04WKZTU",
"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSzT4j0Gje8x7_P2wXtWxkARyNd3dPsHobpRRO67jU8ZzXYrItiFU6YySS1jR1HrQpsM8pC0A-8_OBKyC1RY0XWySh1qymXiiLQlfQ63A4IIXVMv4hTCziMyj8",
"https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcS4aWJkCXACrgLac7oyrljeIBQm7v-30Ze8YatzxdhvEKqPgXNoe6Do56zrOAomY7sLnaAnvA2K0BOcbmMzA1WpNkZ_PWY8HwwXL6yI11aNnrVL8mWjyiU9vA",
"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcRg6lXO4TRLujKVGgToeep6T5jhZ-L44uKM2b1BbqnYvUgiVmA1W_xwTgYnMHek-sUfeqzXuxVG4zA-YZ9MZTvcGmHptbsz_7uiBel4ENFTntm8WI4nv2p_",
"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcS_Pl-wtrkb3Akrv2x0LIif2-K6qKhdhYj3F7cZoRz9lbxDM3QPmQ6WoFXsjvVsIreb4V0AVsAjDr8GuLSim6yvh0EFmm3TPLxTnfjWyO4",
"https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcQ9G_9udLJRhrhNyLjnXvTu7p7OTt17ZPvQoOprsO8gws63HO5qFH7Le1BRulwHwOw-W-9-E8v1ZFjXopiH5-hY0ZpfI-5CnaQkrc90gSpyEgwU-y6qUtrjzQ",
"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcQMoMaUvEZLvf8t8UJcWOxw4piwYaGSMQ7jVsHDZc1IhG9era-c_Gg_G13SgRjD71TshH1PjNmuWIp2b_vsIz2hc79MiWRJGxxM1_ptEMWfUpVNvKzqVRxmDHk",
"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcS-JhhdTPAtxEvHSS8CGrqw2GNSN9E2gRx4rDwKmn4iJ8kgN87SSZdCiaFF8irijJwyLHIa-5g3U5eFpL0UzfIFSEZvG_3Obg_3uDIr-WnzgKHBNeJY_LtaAbA"
],
"features": null,
"rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4.6517005,
"votes_count": 735,
"rating_max": 5
},
"seller_reviews_count": 735,
"sellers": [
{
"type": "product_seller",
"title": "Apple",
"url": "https://www.apple.com/us/xc/product/MG7L4LL/A?cppart=UNLOCKED&cid=aos-us-seo-pla-iphone",
"seller_rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4.681586,
"votes_count": 14604,
"rating_max": 5
},
"seller_review_count": 14604,
"price": {
"current": 1099,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": "$1,099.00"
},
"delivery_info": null
},
{
"type": "product_seller",
"title": "T-Mobile",
"url": "https://www.t-mobile.com/cell-phone/apple-iphone-17-pro?sku=195950626179&srsltid=AfmBOoqtaKFAlP91GuKxJCMQVRtMEE3Y5V6PyPGHzL0iLP88_tjuiBJ4hFg",
"seller_rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 3.9490192,
"votes_count": 152,
"rating_max": 5
},
"seller_review_count": 152,
"price": {
"current": 1099.92,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": "$45.83 for 24 mo"
},
"delivery_info": null
},
{
"type": "product_seller",
"title": "Best Buy",
"url": "https://www.bestbuy.com/product/apple-iphone-17-pro-256gb-cosmic-orange-at-t/JCQ6HHJ56R/sku/6487346?utm_source=feed",
"seller_rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4.5265017,
"votes_count": 2498,
"rating_max": 5
},
"seller_review_count": 2498,
"price": {
"current": 1100.16,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": "$30.56 for 36 mo"
},
"delivery_info": null
},
{
"type": "product_seller",
"title": "AT&T",
"url": "https://www.att.com/buy/phones/apple-iphone-17-pro.html",
"seller_rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": 4.2778463,
"votes_count": 30,
"rating_max": 5
},
"seller_review_count": 30,
"price": {
"current": 1100.16,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": "$30.56 for 36 mo"
},
"delivery_info": null
}
],
"variations": null,
"data_docid": null,
"gid": "9961958114952839788",
"specifications": [
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Brand",
"specification_value": "Apple"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Operating System",
"specification_value": "iOS"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Carrier",
"specification_value": "T-Mobile, AT&T, Verizon, Boost Mobile, TracFone, Cricket, Unlocked"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Smartphone",
"specification_value": "Yes"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Display Resolution",
"specification_value": "2622 x 1206"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "SIM Support",
"specification_value": "Single SIM"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Connector Type",
"specification_value": "USB C"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Cellular Network",
"specification_value": "GSM"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Color",
"specification_value": "Silver, Deep Blue, Cosmic Orange"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Security",
"specification_value": "Facial Recognition"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "With Wireless Charging",
"specification_value": "Yes"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "With Fast Charging",
"specification_value": "Yes"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "With OLED Display",
"specification_value": "Yes"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Broadband Generation",
"specification_value": "5G"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "SIM Card Type",
"specification_value": "Nano SIM, eSIM"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Lens Type",
"specification_value": "Ultra Wide Angle, Telephoto"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Screen Size",
"specification_value": "6.3″"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Storage Capacity",
"specification_value": "256 GB storage, 512 GB storage, 1 TB storage"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Rear Camera Resolution",
"specification_value": "48 MP rear camera"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "Front Camera Resolution",
"specification_value": "18 MP front camera"
},
{
"type": "shopping_specification",
"rank_group": 0,
"rank_absolute": 0,
"position": "left",
"xpath": null,
"block_name": null,
"specification_name": "RAM",
"specification_value": "8 GB RAM, 12 GB RAM"
}
]
}
]
}
]
}
]
}