Yahoo! Images API

Our Yahoo! Images API allows you to scrape SERP results from Yahoo! Images. The API is accessed through the following endpoint: /search?engine=yahoo_images.

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description

A user may query the following: https://serpapi.abcproxy.com/search?engine=yahoo utilizing a GET request. Head to the playground for a live and interactive demo.

---

Request

HTTP Request

---

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=yahoo_images" \
  -d "p=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "yahoo_images",
    "p": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "yahoo_images",
  p: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=yahoo_images&p=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'yahoo_images',
        'p' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "yahoo_images")
    q.Add("p", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "yahoo_images";
        query["p"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=yahoo_images" +
            "&p=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

Parameters

Search Query

Name	Type	Required	Description	Example
p	string	Yes	Parameter defines the search query. You can use anything that you would use in a regular Yahoo! search.	coffee

Localization

Name	Type	Required	Description	Example
yahoo_domain	string	No	Parameter defines the Yahoo! domain to use.	fr.search.yahoo.com

Advanced Yahoo Images Parameters

Name	Type	Required	Description	Example
imgsz	string	No	Parameter is used for filtering images by size. It can be set to: small - Small medium - Medium large - Large wallpaper - Extra Large	-
imgc	string	No	Parameter is used for filtering images by color. It can be set to: color - Color Only bw - Black & white red - Red color orange - Orange color yellow - Yellow color green - Green color teal - Teal color blue - Blue color purple - Purple color pink - Pink color brown - Brown color black - Black color gray - Gray color white - White color	-
imgty	string	No	Parameter is used for filtering images by image type. It can be set to: photo - Photo clipart - Clipart linedrawing - Line Drawing gif - Animated GIF transparent - Transparent	-
imga	string	No	Parameter is used for filtering images by layout. It can be set to: square - Square wide - Wide tall - Tall	-
imgf	string	No	Parameter is used for filtering images by people. It can be set to: face - Faces Only portrait - Head & Shoulders nonportrait - No People	-
imgt	string	No	Parameter is used for filtering images by time. It can be set to: day - Past 24 hours week - Past week month - Past month year - Past year	-
imgl	string	No	Parameter is used for filtering images by usage rights. It can be set to: cc - All Creative Commons pd - Public Domain fsu - Free to share and use fsuc - Free to share and use commercially fmsu - Free to modify, share and use fmsuc - Free to modify, share, and use commercially	-

Pagination

Name	Type	Required	Description	Example
b	int	Yes	Parameter defines the result offset. It skips the given number of results. It's used for pagination.	1

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to yahoo_images to use the Yahoo! Images API engine.	yahoo
no_c1ache	boolean	No	Parameter will force SerpApi to fetch the Google Patents results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month.	true or false
api_key	string	Yes	Parameter defines the SerpApi private key to use.	YOUR_API_KEY

---

Response

Success 200

Response Body

{
  "code": 200,
  "search_parameters": {
    "engine": "yahoo_images",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "p": "Coffee"
  },
  "search_metadata": {
    "id": "d76f0cf8-c810-42b4-9bde-6508b99ce625",
    "json_endpoint": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.json",
    "created_at": "2025-04-09 14:02:33",
    "yahoo_url": "https://images.search.yahoo.com/search/images?p=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/ef62cad087b1ee4c/d76f0cf8-c810-42b4-9bde-6508b99ce625.xray",
    "total_time_taken": "7.1118"
  },
  "images_results": [
    {
      "original": "3.bp.blogspot.com/-U2uqPh7hw0U/UHNEoLahrPI/AAAAAAAAAv8/buuzujhKZkY/s1600/coffee.jpg",
      "source": "http://bellevueclub.blogspot.com/2012/10/coffees-health-benefitsand-how-to-taste.html",
      "size": "191KB",
      "title": "Bellevue Club: Coffee's Health…",
      "position": 1,
      "thumbnail": "https://tse3.mm.bing.net/th?id=OIP.Re7WHLgpMU2E8obQUJb-TAAAAA&pid=Api&P=0&h=220",
      "link": "https://images.search.yahoo.com/images/view;_ylt=Awrihisom_Nn5mEMhUeJzbkF;_ylu=c2VjA3NyBHNsawNpbWcEb2lkA2EwY2NiMDE3MzQzYWZiZWI4MjRhZGQyY2YwOGU0YmQ0BGdwb3MDMQRpdANiaW5n?back=https%3A%2F%2Fimages.search.yahoo.com%2Fsearch%2Fimages%3Fp%3DCoffee%26tab%3Dorganic%26ri%3D1&w=474&h=710&imgurl=3.bp.blogspot.com%2F-U2uqPh7hw0U%2FUHNEoLahrPI%2FAAAAAAAAAv8%2FbuuzujhKZkY%2Fs1600%2Fcoffee.jpg&rurl=http%3A%2F%2Fbellevueclub.blogspot.com%2F2012%2F10%2Fcoffees-health-benefitsand-how-to-taste.html&size=191KB&p=Coffee&oid=a0ccb017343afbeb824add2cf08e4bd4&fr2=&fr=&tt=Bellevue+Club%3A+Coffee%26%2339%3Bs+Health+Benefits...and+How+to+Taste+It%21&b=0&ni=21&no=1&ts=&tab=organic&sigr=rnAAVwMciMuZ&sigb=33bPYwNEOiSX&sigi=AqnI4YQ6m2u2&sigt=SJOEbT5vhcZz&.crumb=czh6bch2gIv&"
    },
    ...
  ],
  "shopping_results": [
    {
      "thumbnail": "https://sp.yimg.com/ib/th?id=OPHS.LWTQIvvNk8YUoA474C474&o=5&pid=21.1&w=174&h=174",
      "seller": "Nespresso US",
      "price": {
        "value": "$13.00",
        "extracted_value": 13
      },
      "position": 1,
      "title": "Nespresso - Melozio - Sleeve Of 10 - Vertuo Coffee Capsules",
      "link": "https://r.search.yahoo.com/rdclks/dWU9NThlNG9rOWp2NzZwOCZ1dD0xNzQ0MDE4MjE2ODYxJnVvPTgyMzk1MDI5MDM4MTg4MSZsdD0yJnM9MSZlcz00SFo0OF9oUGZIS193RVBCOUZZbmN1Sjl6SVpQU0VoQm5mZVRvRHhxdk5SOXNhQkxxbXJXcktXUjQ5MWpCVEFzaEY5a1BzYXBsVjQwUzhJLQ--/RV=2/RE=1746610217/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8NL273pcG6mw9PPhHlKT01zVUCUz4SgCTJKhZgqtSrfsnF8oGhhpChYi4_7897Lj5cL3tSexSMwyfyrPIYpGhvFTGYTgYjmKO51Z6fj1XbL5CifmzhR3gyAD4Vd9-Id-Ax3Ojtce8Y14wFQ02DK4peN1T_OmNl7-VK-5UN9blQ5ihXL7coZMjsk-GMVx9AZnrfrJVOQ%26u%3daHR0cHMlM2ElMmYlMmZhZC5kb3VibGVjbGljay5uZXQlMmZzZWFyY2hhZHMlMmZsaW5rJTJmY2xpY2slM2ZsaWQlM2Q5MjcwMDA4MDYzMzA1OTM2NyUyNmRzX3Nfa3dnaWQlM2Q1ODcwMDAwODcxMDUyNzAzNCUyNmRzX3NfaW52ZW50b3J5X2ZlZWRfaWQlM2Q5NzcwMDAwMDAxMDgyNjE2MSUyNmRzX2FfY2lkJTNkNDA2OTc3Nzg0JTI2ZHNfYV9jYWlkJTNkMjA3OTEyMDg1MjklMjZkc19hX2FnaWQlM2QxNjQ2NTgzOTQ3MjklMjZkc19hX2xpZCUzZHBsYS0yMzM5ODU5MDg5Njc5JTI2JTI2ZHNfZV9hZGlkJTNkODIzOTUwMjkwMzgxODglMjZkc19lX3RhcmdldF9pZCUzZHBsYS00NTg1OTk0Mjg2NTMwNzM3JTI2ZHNfZV9wcm9kdWN0X2dyb3VwX2lkJTNkNDU4NTk5NDI4NjUzMDczNyUyNmRzX2VfcHJvZHVjdF9pZCUzZFVTXzcwMzkuMTAlMjZkc19lX3Byb2R1Y3RfY291bnRyeSUzZFVTJTI2ZHNfZV9wcm9kdWN0X2xhbmd1YWdlJTNkZW4lMjZkc19lX3Byb2R1Y3RfY2hhbm5lbCUzZE9ubGluZSUyNmRzX2VfbmV0d29yayUzZG8lMjZkc191cmxfdiUzZDIlMjZkc19kZXN0X3VybCUzZGh0dHBzJTNhJTJmJTJmd3d3Lm5lc3ByZXNzby5jb20lMmZ1cyUyZmVuJTJmb3JkZXIlMmZjYXBzdWxlcyUyZnZlcnR1byUyZm1lbG96aW8tdmVydHVvLWNvZmZlZS1wb2RzJTNmZ2NsaWQlM2RjYzNlYzk3NjJmNTkxMGQ5NGE0M2FlODViNDcwYWQ0MSUyNmdjbHNyYyUzZDNwLmRzJTI2bXNjbGtpZCUzZGNjM2VjOTc2MmY1OTEwZDk0YTQzYWU4NWI0NzBhZDQx%26rlid%3dcc3ec9762f5910d94a43ae85b470ad41/RK=2/RS=Tbehb3lscjq8kQknOUN6BjlxRUY-;_ylt=Awrihisom_Nn5mEM0kaJzbkF;_ylu=cG9zAzEEc2VjA292LXRvcC1wbGE-;_ylc=cnQDMA--?p=Coffee"
    },
    ...
  ],
  ...
}

Response Fields

Field	Type	Description
search_parameters	object	Contains query parameters and search context
search_metadata	object	Containstiming and status information
images_results	object[]	List of image search results
shopping_results	object[]	List of shopping related results
related_searches	object[]	List of related search suggestions
suggested_searches	object[]	List of suggested search queries

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	API Key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---