Google Images Results API
The Google Images Results API allows a user to scrape images from a Google Images search results page. When SerpApi encounters image results, we add them to our JSON output as the array image_results
. Head to the playground for a live and interactive demo.
If you are interested in the reverse image search - head to our Reverse Image API.
API Examples
JSON structure overview
{
"images_results": [
{
"position": "Integer - Image index",
"thumbnail": "String - Google Thumbnail URL (cache)",
"related_content_id": "String - Unique ID for retrieving the Related Content of an image",
"serpapi_related_content_link": "String - Link to SerpApi to fetch the Related Content of an image",
"original": "String - Original Image URL (full resolution)",
"original_width": "Integer - Original Image width",
"original_height": "Integer - Original Image height",
"title": "String - Short Image Description",
"tag": "String - Optional tag of the image",
"link": "String - Link to the page providing the image",
"source": "String - Original Domain Name",
"is_product": "Boolean - Is the link to the page providing the image containing a product",
"in_stock": "Boolean - Is product in stock"
},
...
],
}
Results for: Apple
{
...
"shopping_results": [
{
"position": 1,
"title": "iPhone 13 20W Apple Certified USB C Fast Charger for iPhone 13/13 mini/13 Pro/13 Pro Max 12/12 mini/12 Pro/12 Pro Max/11/11 Pro/11 Pro Max/XS/XR/X/8",
"price": "$19.99",
"extracted_price": 19.99,
"link": "https://www.amazon.com/iPhone-Certified-Charger-Type-C-Lightning/dp/B09B72F9CS?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A19ZDYPFLKPVN6",
"source": "Amazon.com",
"thumbnail": "<URL to image>"
},
{
"position": 2,
"title": "Cosmic Crisp Apples - each",
"price": "$0.99",
"extracted_price": 0.99,
"link": "https://www.target.com/p/cosmic-crisp-apples-each/-/A-79154064?ref=tgt_adv_XS000000&AFID=google_pla_df_free_local&CPNG=Grocery&adgroup=266-5",
"source": "Target",
"thumbnail": "<URL to image>"
},
{
"position": 3,
"title": "Apple Watch Ultra GPS + Cellular, 49mm Titanium Case with Orange Alpine Loop - Medium",
"price": "$799.00",
"extracted_price": 799,
"link": "https://www.apple.com/us/shop/go/product/MQEU3?cid=aos-us-seo-pla",
"source": "Apple",
"thumbnail": "<URL to image>"
},
...
],
"images_results": [
{
"position": 1,
"thumbnail": "<URL to image>",
"related_content_id": "d3ZFQTJGZ1dtVUVDZk1cIixcIjZQTFZWdWJTLWdNZ2RN",
"serpapi_related_content_link": "https://serpapi.com/search.json?related_content_id=d3ZFQTJGZ1dtVUVDZk1cIixcIjZQTFZWdWJTLWdNZ2RN&engine=google_images_related_content&gl=us&hl=en&q=Apple",
"source": "New York Apple Association",
"title": "SnapDragon® - New York Apple Association",
"link": "https://www.applesfromny.com/varieties/snapdragon/",
"original": "<URL to image>",
"original_width": 2400,
"original_height": 1889,
"is_product": false
},
{
"position": 2,
"thumbnail": "<URL to image>",
"related_content_id": "a3RjeHZGNUxhWHlWWE1cIixcIkMwRVJlOXBJSHZIZmdN",
"serpapi_related_content_link": "https://serpapi.com/search.json?related_content_id=a3RjeHZGNUxhWHlWWE1cIixcIkMwRVJlOXBJSHZIZmdN&engine=google_images_related_content&gl=us&hl=en&q=Apple",
"source": "New York Apple Association",
"title": "Varieties Archive - New York Apple Association",
"link": "https://www.applesfromny.com/varieties/",
"original": "<URL to image>",
"original_width": 2400,
"original_height": 1889,
"is_product": false
},
...
],
"suggested_searches": [
{
"name": "Logo",
"link": "https://www.google.com/search?sca_esv=221f3c1ac0fa11b3&sca_upv=1&q=apple+logo&uds=AMwkrPujEvoKO88_gtxxkRd0v3RzhyhkqYCqvtbEuGrAPAoXk7OxEykGFZujOUBdRS-EuogruysWL1hjUkKgDZVq2wrKVBm-zvsTGvEB8QBuR8iP_LeP8P65adjeoBum5RmQSIaPM-V4B9MV8zK3dH27TqSJtoqJcAjebG908XAHoOI2Jls_7AyxKJEh4DEQUFZTDefu-xAegG3_uHO3npBMcoAWVtoKrq8607ASD9sW1_YUB3W71F_m_EQpWmGFFLAVyacF22-chndjx8jUhlHIj_PlFXvfwqkyGSnW6FCackfzOTc8z8e9-B-kDgGq4UWlXJI9Ci6R5jDHIp9Nok54dvkZpo1OrA&udm=2&sa=X&ved=2ahUKEwj8uZSlyruFAxUASvEDHWiQDgwQxKsJegQICRAB&ictx=0",
"uds": "AMwkrPujEvoKO88_gtxxkRd0v3RzhyhkqYCqvtbEuGrAPAoXk7OxEykGFZujOUBdRS-EuogruysWL1hjUkKgDZVq2wrKVBm-zvsTGvEB8QBuR8iP_LeP8P65adjeoBum5RmQSIaPM-V4B9MV8zK3dH27TqSJtoqJcAjebG908XAHoOI2Jls_7AyxKJEh4DEQUFZTDefu-xAegG3_uHO3npBMcoAWVtoKrq8607ASD9sW1_YUB3W71F_m_EQpWmGFFLAVyacF22-chndjx8jUhlHIj_PlFXvfwqkyGSnW6FCackfzOTc8z8e9-B-kDgGq4UWlXJI9Ci6R5jDHIp9Nok54dvkZpo1OrA",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=google_images&gl=us&google_domain=google.com&hl=en&ijn=0&q=Apple&uds=AMwkrPujEvoKO88_gtxxkRd0v3RzhyhkqYCqvtbEuGrAPAoXk7OxEykGFZujOUBdRS-EuogruysWL1hjUkKgDZVq2wrKVBm-zvsTGvEB8QBuR8iP_LeP8P65adjeoBum5RmQSIaPM-V4B9MV8zK3dH27TqSJtoqJcAjebG908XAHoOI2Jls_7AyxKJEh4DEQUFZTDefu-xAegG3_uHO3npBMcoAWVtoKrq8607ASD9sW1_YUB3W71F_m_EQpWmGFFLAVyacF22-chndjx8jUhlHIj_PlFXvfwqkyGSnW6FCackfzOTc8z8e9-B-kDgGq4UWlXJI9Ci6R5jDHIp9Nok54dvkZpo1OrA",
"thumbnail": "<URL to image>"
},
{
"name": "red",
"link": "https://www.google.com/search?sca_esv=221f3c1ac0fa11b3&sca_upv=1&q=apple+logo&uds=AMwkrPu_54wJAGwKfpxF7r7p0Dry82z4VUt-fUSGRFt0VbTTaB_76YygSdHXvn3TYuTL9Tnb9lfKW_QO64kDajQqBuf0pCj9akaAoCoHXtE0lMv7tDsV5lMt2bkb66b8ML7_ebgcNfWb-FyEdo_bSFgjELRJDBfm9Vow_dXV5AoBAR65pBJVRukiXWfqiT8c0UdYOewfog2Yco_Nfbboobl3hInzzGVPlvCXlUi-Ntt_HENuZe2NxTKwss61G_OoR7zMSpwVyIzFrKvxVjKcijQMirxXY9FiiVraeL7LkHZVsuAHRAfV7wzxm9shZ-GY5IM12emc_lnHPlx9zMKRYXwyZCiPIR6H2Q&udm=2&sa=X&ved=2ahUKEwj8uZSlyruFAxUASvEDHWiQDgwQxKsJegQICRAB&ictx=0",
"chips": "q:apple,g_1:red:MbDAkgkowSA%3D",
"serpapi_link": "https://serpapi.com/search.json?device=mobile&engine=google_images&gl=us&google_domain=google.com&hl=en&ijn=0&q=Apple&uds=AMwkrPu_54wJAGwKfpxF7r7p0Dry82z4VUt-fUSGRFt0VbTTaB_76YygSdHXvn3TYuTL9Tnb9lfKW_QO64kDajQqBuf0pCj9akaAoCoHXtE0lMv7tDsV5lMt2bkb66b8ML7_ebgcNfWb-FyEdo_bSFgjELRJDBfm9Vow_dXV5AoBAR65pBJVRukiXWfqiT8c0UdYOewfog2Yco_Nfbboobl3hInzzGVPlvCXlUi-Ntt_HENuZe2NxTKwss61G_OoR7zMSpwVyIzFrKvxVjKcijQMirxXY9FiiVraeL7LkHZVsuAHRAfV7wzxm9shZ-GY5IM12emc_lnHPlx9zMKRYXwyZCiPIR6H2Q",
"thumbnail": "<URL to image>"
},
{
"name": "Fruit",
"link": "https://www.google.com/search?sca_esv=221f3c1ac0fa11b3&sca_upv=1&q=apple+fruit+images&uds=AMwkrPuv_kvMoMCAqup72mhE6FekLHcL3SifwcZpZ3maU-P62shsm7_8yw6VCvBNmxtxOCym2s_wgrULHT5d_P5Z8r8-g-3qKGOGTt03WAh6ZPsg_0VnEfR-9ucoz32l3YPSAgnG6g5VYZN00DjXTs2CVdrNce7y69U6f2F6RCqFRvLJeVkcuW9mFSjcMJ9aX3yQA1Jub7pPl72eTSait4WxaQRFS3goU98vxoaimvQJwoy4q2zlIuQAXQocypciivAQo-6M62hq2_ansYJHc3x9kP9nJ5SJizFb6k8z2KwunAM-oIvvp9ia0baJQP25gqiuJAhKRvRTOHzi15jPfJcJnWW6rlcEbQ&udm=2&sa=X&ved=2ahUKEwj8uZSlyruFAxUASvEDHWiQDgwQxKsJegQIDRAB&ictx=0",
"uds": "AMwkrPuv_kvMoMCAqup72mhE6FekLHcL3SifwcZpZ3maU-P62shsm7_8yw6VCvBNmxtxOCym2s_wgrULHT5d_P5Z8r8-g-3qKGOGTt03WAh6ZPsg_0VnEfR-9ucoz32l3YPSAgnG6g5VYZN00DjXTs2CVdrNce7y69U6f2F6RCqFRvLJeVkcuW9mFSjcMJ9aX3yQA1Jub7pPl72eTSait4WxaQRFS3goU98vxoaimvQJwoy4q2zlIuQAXQocypciivAQo-6M62hq2_ansYJHc3x9kP9nJ5SJizFb6k8z2KwunAM-oIvvp9ia0baJQP25gqiuJAhKRvRTOHzi15jPfJcJnWW6rlcEbQ",
"serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=google_images&gl=us&google_domain=google.com&hl=en&ijn=0&q=Apple&uds=AMwkrPuv_kvMoMCAqup72mhE6FekLHcL3SifwcZpZ3maU-P62shsm7_8yw6VCvBNmxtxOCym2s_wgrULHT5d_P5Z8r8-g-3qKGOGTt03WAh6ZPsg_0VnEfR-9ucoz32l3YPSAgnG6g5VYZN00DjXTs2CVdrNce7y69U6f2F6RCqFRvLJeVkcuW9mFSjcMJ9aX3yQA1Jub7pPl72eTSait4WxaQRFS3goU98vxoaimvQJwoy4q2zlIuQAXQocypciivAQo-6M62hq2_ansYJHc3x9kP9nJ5SJizFb6k8z2KwunAM-oIvvp9ia0baJQP25gqiuJAhKRvRTOHzi15jPfJcJnWW6rlcEbQ",
"thumbnail": "<URL to image>"
},
...
],
...
}
Images Pagination
Images are fetched by batch of 100 images per search. To fech additional images, you need to perform the same search again, incrementing the ijn
parameter for each page of results you want to retrieve. As an example, to get the first 300 images for the search "Apple":
Images Advanced Filter Search
tbs=iar
(aspect ratio) has been deprecated by Google. Use parameter imgar
instead (imgar documentation)
Google Images provides a way to filter by size, image type, and more. This information is encoded in the tbs
parameter. E.g., tbs=itp:photos,isz:l
selects only large photos.
- • https://serpapi.com/playground?q=apple&engine=google_images&ijn=0&tbs=itp:photos,isz:l
- • https://serpapi.com/playground?q=apple&engine=google_images&ijn=1&tbs=itp:photos,isz:l
tbs
parameter, you can perform a regular Google Images search in your browser and copy the value of the field tbs
from the url:
- 1. Enable Tools dropdown on the right
- 2. Select the image filters you want to use
Your browser URL should contains somthing like: ...&tbs=itp:photos,isz:l...
. You can use this value directly on SerpApi.