{"id":7177,"date":"2020-10-01T10:33:04","date_gmt":"2020-10-01T10:33:04","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=7177"},"modified":"2025-03-19T14:47:23","modified_gmt":"2025-03-19T14:47:23","slug":"serp-google-search_by_image-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/serp-google-search_by_image-overview\/","title":{"rendered":"serp\/google\/search_by_image\/overview"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Google Search By Image SERP: Overview<\/h1>\n
\n \"checked\"\n\n This API is designed to provide you with search results Google Lens returns for a specific image <\/div>\n \n

The returned results are specific to the indicated image, search engine, and location parameters. You will receive all available search results from Google Lens along with a keyword associated with the indicated image.
\n\u200c
\nExample of Google Search By Image results:<\/p>\n

\"\"<\/p>\n

We emulate set location and search engine with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url<\/code> in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned SERP results.<\/p>\n

Note:<\/strong> Google Search By Image API provides results for desktop<\/code> only.
\n\u200c\u200c <\/p>\n

Google Search By Image SERP functions<\/h3>\n

 
\nGoogle Search By Image Advanced endpoint<\/a> provides data on the top 100 results from Google Search for the specified image, search engine, and location. Using this endpoint you will get a complete overview of images listed in SERP along with their positions, URLs, titles, and other included items.
\n 
\nGoogle V2 HTML endpoint<\/a> provides a raw HTML page of the top Google Search by Image results for the specified keyword, search engine, and location.
\n\u200c <\/p>\n

Methods<\/h3>\n

 
\nThe cost of using Google Search By Image SERP endpoints depends on the selected method and priority of task execution. Available methods and priorities are described below.<\/p>\n

DataForSEO supports only the Standard for delivering SERP results. This method requires making separate POST<\/a> and GET<\/a> requests to the corresponding endpoints. Using this method, you can retrieve the results after our system collects them.<\/p>\n

\u200cAlternatively, you can specify pingback_url<\/code> or postback_url<\/code> when setting a task, and we will notify you on completion of tasks or send the results to you respectively. Note that if you use the postback_url<\/code> field, you should also indicate the function that will be applied for data retrieval: advanced<\/code>, html<\/code>. <\/p>\n

If you use the Standard method without specifying pingback_url<\/code> or postback_url<\/code>, you can receive the list of id for all completed tasks using the ‘Tasks Ready’<\/strong> endpoint. It is designed to provide you with the list of completed tasks, which haven’t been collected yet. Then, you can retrieve the results using the \u2018Task GET\u2019<\/strong> endpoint.<\/p>\n

Learn more about task completion and obtaining a list of completed tasks in this help center article.<\/a> <\/p>\n

You can send up to 2000 POST and GET API calls per minute in total, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit.  \u200c<\/p>\n

Priorities and cost<\/h3>\n

 
\nThe Standard method has two different priorities that stand for the relative speed of task execution and have different prices:<\/p>\n

1. Normal priority;
\n2. High priority.<\/p>\n

The cost can be calculated on the Pricing<\/a> page. <\/p>\n

[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"

[vc_row][vc_column][vc_column_text] Google Search By Image SERP: Overview This API is designed to provide you with search results Google Lens returns for a specific image The returned results are specific to the indicated image, search engine, and location parameters. You will receive all available search results from Google Lens along with a keyword associated with the […]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-7177","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/7177","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=7177"}],"version-history":[{"count":23,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/7177\/revisions"}],"predecessor-version":[{"id":21208,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/7177\/revisions\/21208"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=7177"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}