Yahoo Images API Documentation

GET   /api/v1/search?engine=yahoo_images

Search Yahoo Images and retrieve image titles, source pages, original image URLs with their width and height, thumbnails, suggested searches, related searches, and shopping ads as structured JSON, 60 images per page.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    This parameter is used for the terms you want to search on Yahoo Images. Queries can include quoted phrases and the site: operator.

Localization

  • Name
    yahoo_domain
    Required
    Optional
    Description

    The default parameter search.yahoo.com defines the Yahoo domain of the search. Each domain searches its own market, so results differ between domains. Check the full list of supported Yahoo Images yahoo_domain domains.

Filters

  • Name
    safe
    Required
    Optional
    Description

    Specifies the filter level for adult content. Available values are:

    • on Default
    • off

  • Name
    size
    Required
    Optional
    Description

    Filters images by size. Available values are:

    • small
    • medium
    • large
    • extra_large

  • Name
    color
    Required
    Optional
    Description

    Filters images by color. Available values are:

    • color - color images only.
    • black_and_white
    • red
    • orange
    • yellow
    • green
    • teal
    • blue
    • purple
    • pink
    • brown
    • black
    • gray
    • white

  • Name
    image_type
    Required
    Optional
    Description

    Filters images by type. Available values are:

    • photo
    • clipart
    • line_drawing
    • gif - animated images.
    • transparent - images with a transparent background.
    Can be combined with people.

  • Name
    people
    Required
    Optional
    Description

    Filters images by the people they show. Can be combined with image_type, for example image_type=photo and people=no_people. Available values are:

    • face - close-ups of faces.
    • head_and_shoulders - portraits.
    • no_people - Yahoo's No People filter. Results may still show people.

  • Name
    aspect_ratio
    Required
    Optional
    Description

    Filters images by layout. Available values are:

    • square - width equals height.
    • wide - width greater than height.
    • tall - height greater than width.

  • Name
    time_period
    Required
    Optional
    Description

    Filters images by how recently they were found. Available values are:

    • last_day
    • last_week
    • last_month
    • last_year

  • Name
    usage_rights
    Required
    Optional
    Description

    Filters images by license. Available values are:

    • creative_commons_licenses - any Creative Commons license.
    • public_domain
    • free_to_share_and_use
    • free_to_share_and_use_commercial - including commercial use.
    • free_to_modify_share_and_use
    • free_to_modify_share_and_use_commercial - including commercial use.

Pagination

  • Name
    page
    Required
    Optional
    Description

    This parameter indicates which page of results to return, with up to 60 images per page. By default, it is set to 1. A page past the last one returns an error.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to yahoo_images.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=golden+retriever
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "golden retriever"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Ddtnsnz65MsmOtJhMdMkABUq",
    "status": "Success",
    "created_at": "2026-11-12T13:23:31Z",
    "request_time_taken": 2.65,
    "parsing_time_taken": 0.0,
    "total_time_taken": 2.65,
    "request_url": "https://images.search.yahoo.com/search/images?p=golden+retriever&vm=r",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Ddtnsnz65MsmOtJhMdMkABUq.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Ddtnsnz65MsmOtJhMdMkABUq"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "golden retriever",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on"
  },
  "search_information": {
    "query_displayed": "golden retriever"
  },
  "suggestions": [
    {
      "title": "Cute Smiling",
      "link": "https://images.search.yahoo.com/search/images?p=Cute+Smiling",
      "thumbnail": "https://s.yimg.com/fz/api/res/1.2/P8asVbBqIJzgTR_RAmlSCw--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05Njt3PTk..."
    },
    "..."
  ],
  "images": [
    {
      "position": 1,
      "title": "Golden Retriever | Breed, Size, Temperament & Coat | Britannica",
      "source": {
        "name": "www.britannica.com",
        "link": "https://www.britannica.com/animal/golden-retriever-dog"
      },
      "original": {
        "link": "https://cdn.britannica.com/65/102265-050-EC17E3B0/retriever-puppies.jpg",
        "width": 1600,
        "height": 1067
      },
      "thumbnail": "https://tse4.mm.bing.net/th/id/OIP.GAJ0MeHJaD7I4ePDWMnEKAHaE8?r=0&pid=Api&h=220&P=0"
    },
    "..."
  ],
  "related_searches": [
    {
      "query": "Golden Retriever Clip Art",
      "link": "https://images.search.yahoo.com/search/images?p=Golden+Retriever+Clip+Art",
      "thumbnail": "https://s.yimg.com/fz/api/res/1.2/dfWdBpZcJs4BMNzUYQtwYg--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD04ODt3PTg..."
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": "https://images.search.yahoo.com/search/images?vm=r&p=golden+retriever&b=61"
  }
}

The images array holds the results in page order. Each image has the source page it appears on, the full-size original file with its width and height in pixels, and a thumbnail. suggestions are the refinements shown above the results, and related_searches are the related queries shown among them. Pass a related search query back as q to follow it. For product queries, shopping_ads lists each advertised product once, with its price, seller and store link.

pagination.next is present while Yahoo has more results. Broad queries usually end between pages 7 and 10. Request the next page with the page parameter. A page past the last one returns HTTP 200 with error: "Yahoo Images has no more results for the requested page.", and a query with no results returns error: "Yahoo Images did not return any results.". Results can repeat between pages, so deduplicate by original.link when collecting several pages.

Size and Layout Filters

Size and Layout Filters
GET
https://www.searchapi.io/api/v1/search?aspect_ratio=wide&engine=yahoo_images&q=mountain+lake&size=extra_large
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "mountain lake",
  "size": "extra_large",
  "aspect_ratio": "wide"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_k3SxSWrfAzkAWGu4CK1QE4U1",
    "status": "Success",
    "created_at": "2026-11-12T13:23:34Z",
    "request_time_taken": 1.34,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.34,
    "request_url": "https://images.search.yahoo.com/search/images?p=mountain+lake&vm=r&imgsz=wallpaper&imga=wide",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_k3SxSWrfAzkAWGu4CK1QE4U1.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_k3SxSWrfAzkAWGu4CK1QE4U1"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "mountain lake",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on",
    "size": "extra_large",
    "aspect_ratio": "wide"
  },
  "search_information": {
    "query_displayed": "mountain lake"
  },
  "images": [
    {
      "position": 1,
      "title": "Beautiful Mountain Lake Wallpapers - Top Free Beautiful Mountain Lake ...",
      "source": {
        "name": "wallpaperaccess.com",
        "link": "https://wallpaperaccess.com/beautiful-mountain-lake"
      },
      "original": {
        "link": "https://wallpaperaccess.com/full/1223740.jpg",
        "width": 3840,
        "height": 2400
      },
      "thumbnail": "https://tse4.mm.bing.net/th/id/OIP.CTRSe1i4fuZBsTfMQ0vhvAHaEo?r=0&pid=Api&h=220&P=0"
    },
    "..."
  ]
}

Usage Rights

Usage Rights
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&image_type=photo&q=sunflower&usage_rights=free_to_share_and_use_commercial
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "sunflower",
  "usage_rights": "free_to_share_and_use_commercial",
  "image_type": "photo"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_65S1VBMsOddcSCbxcVtvia73",
    "status": "Success",
    "created_at": "2026-11-12T13:23:36Z",
    "request_time_taken": 1.69,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.7,
    "request_url": "https://images.search.yahoo.com/search/images?p=sunflower&vm=r&imgl=fsuc&imgty=photo",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_65S1VBMsOddcSCbxcVtvia73.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_65S1VBMsOddcSCbxcVtvia73"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "sunflower",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on",
    "image_type": "photo",
    "usage_rights": "free_to_share_and_use_commercial"
  },
  "search_information": {
    "query_displayed": "sunflower"
  },
  "images": [
    {
      "position": 1,
      "title": "sunflower – Wiktionary",
      "source": {
        "name": "de.wiktionary.org",
        "link": "https://de.wiktionary.org/wiki/sunflower"
      },
      "original": {
        "link": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/40/Sunflower_sky_backdrop.jpg/440px-Sunflower...",
        "width": 440,
        "height": 487
      },
      "thumbnail": "https://tse4.mm.bing.net/th/id/OIP.EomLAIlQwP8vJvLzNIYpIgAAAA?r=0&pid=Api&h=220&P=0"
    },
    "..."
  ]
}

Suggestions

Suggestions
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=coffee
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "coffee"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_d5FkRkcVnKz1OW3qUkLMDjh3",
    "status": "Success",
    "created_at": "2026-11-12T13:23:38Z",
    "request_time_taken": 1.54,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.54,
    "request_url": "https://images.search.yahoo.com/search/images?p=coffee&vm=r",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_d5FkRkcVnKz1OW3qUkLMDjh3.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_d5FkRkcVnKz1OW3qUkLMDjh3"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "coffee",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on"
  },
  "search_information": {
    "query_displayed": "coffee"
  },
  "suggestions": [
    {
      "title": "coffee Art",
      "link": "https://images.search.yahoo.com/search/images?p=Coffee+Art",
      "thumbnail": "https://s.yimg.com/fz/api/res/1.2/yaJNusr85jt2Y.ZO8N_ECg--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05Njt3PTk..."
    },
    "..."
  ]
}

Shopping Ads

Shopping Ads
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=office+chair
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "office chair"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_l4X6Gv2KrqHIZcdL8xZT1zp3",
    "status": "Success",
    "created_at": "2026-11-13T09:56:15Z",
    "request_time_taken": 2.56,
    "parsing_time_taken": 0.01,
    "total_time_taken": 2.57,
    "request_url": "https://images.search.yahoo.com/search/images?p=office+chair&vm=r",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_l4X6Gv2KrqHIZcdL8xZT1zp3.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_l4X6Gv2KrqHIZcdL8xZT1zp3"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "office chair",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on"
  },
  "search_information": {
    "query_displayed": "office chair"
  },
  "shopping_ads": [
    {
      "position": 1,
      "title": "Staples Dexley Ergonomic Mesh Swivel Task Chair, Black (UN56946V-CC)",
      "seller": "Staples",
      "link": "https://www.staples.com/union-scale-flexfit-dexley-ergonomic-mesh-swivel-task-chair-black-un56946/pr...",
      "price": "$145.99",
      "extracted_price": 145.99,
      "image": "https://sp.yimg.com/ib/th?id=OPHS.Gn1csiOCUwuD6A474C474&o=5&pid=21.1&w=174&h=174"
    },
    "..."
  ]
}
Related Searches
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&image_type=gif&q=cat+dancing
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "cat dancing",
  "image_type": "gif"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_ciRketaBwEHs1F15ZXCEm26W",
    "status": "Success",
    "created_at": "2026-11-12T13:23:40Z",
    "request_time_taken": 1.37,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.38,
    "request_url": "https://images.search.yahoo.com/search/images?p=cat+dancing&vm=r&imgty=gif",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_ciRketaBwEHs1F15ZXCEm26W.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_ciRketaBwEHs1F15ZXCEm26W"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "cat dancing",
    "yahoo_domain": "search.yahoo.com",
    "safe": "on",
    "image_type": "gif"
  },
  "search_information": {
    "query_displayed": "cat dancing"
  },
  "related_searches": [
    {
      "query": "Dancing Cat Animated Emoticons",
      "link": "https://images.search.yahoo.com/search/images?p=Dancing+Cat+Animated+Emoticons",
      "thumbnail": "https://s.yimg.com/fz/api/res/1.2/627zRPZGffC02C4Q9Wpp.A--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD04ODt3PTg..."
    },
    "..."
  ]
}

Regional Results and Pagination

Regional Results and Pagination
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_images&page=2&q=eiffel+tower&yahoo_domain=fr.search.yahoo.com
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo_images",
  "q": "eiffel tower",
  "yahoo_domain": "fr.search.yahoo.com",
  "page": 2
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_no5LvjJcAWYFvKJbtgx0ea3w",
    "status": "Success",
    "created_at": "2026-11-12T13:23:41Z",
    "request_time_taken": 1.5,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.5,
    "request_url": "https://fr.images.search.yahoo.com/search/images?p=eiffel+tower&vm=r&b=61",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_no5LvjJcAWYFvKJbtgx0ea3w.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_no5LvjJcAWYFvKJbtgx0ea3w"
  },
  "search_parameters": {
    "engine": "yahoo_images",
    "q": "eiffel tower",
    "yahoo_domain": "fr.search.yahoo.com",
    "safe": "on",
    "page": 2
  },
  "search_information": {
    "query_displayed": "eiffel tower"
  },
  "images": [
    {
      "position": 1,
      "title": "Paris Eiffel Tower Wallpapers | HD Wallpapers | ID #13017",
      "source": {
        "name": "www.hdwallpapers.in",
        "link": "http://www.hdwallpapers.in/paris_eiffel_tower-wallpapers.html"
      },
      "original": {
        "link": "http://www.hdwallpapers.in/walls/paris_eiffel_tower-wide.jpg",
        "width": 2880,
        "height": 1800
      },
      "thumbnail": "https://tse2.mm.bing.net/th/id/OIP.TSYK5q2iOdulWXiRqen32AHaEo?r=0&pid=Api&h=220&P=0"
    },
    "..."
  ],
  "pagination": {
    "current": 2,
    "next": "https://fr.images.search.yahoo.com/search/images?vm=r&p=eiffel+tower&b=121"
  }
}

Suggestions and related searches appear on search.yahoo.com and are usually absent on other domains.