Yahoo Images API Documentation
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.comdefines the Yahoo domain of the search. Each domain searches its own market, so results differ between domains. Check the full list of supported Yahoo Imagesyahoo_domaindomains.
Filters
-
- Name
-
safe - Required
- Optional
- Description
-
Specifies the filter level for adult content. Available values are:
-
onDefault off
-
-
- Name
-
size - Required
- Optional
- Description
-
Filters images by size. Available values are:
smallmediumlargeextra_large
-
- Name
-
color - Required
- Optional
- Description
-
Filters images by color. Available values are:
color- color images only.black_and_whiteredorangeyellowgreentealbluepurplepinkbrownblackgraywhite
-
- Name
-
image_type - Required
- Optional
- Description
-
Filters images by type. Available values are:
photoclipartline_drawinggif- animated images.transparent- images with a transparent background.
people.
-
- Name
-
people - Required
- Optional
- Description
-
Filters images by the people they show. Can be combined with
image_type, for exampleimage_type=photoandpeople=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_daylast_weeklast_monthlast_year
-
- Name
-
usage_rights - Required
- Optional
- Description
-
Filters images by license. Available values are:
creative_commons_licenses- any Creative Commons license.public_domainfree_to_share_and_usefree_to_share_and_use_commercial- including commercial use.free_to_modify_share_and_usefree_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_keyauthenticates 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
trueto 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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=golden+retriever
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?aspect_ratio=wide&engine=yahoo_images&q=mountain+lake&size=extra_large
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&image_type=photo&q=sunflower&usage_rights=free_to_share_and_use_commercial
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=coffee
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&q=office+chair
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&image_type=gif&q=cat+dancing
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=yahoo_images&page=2&q=eiffel+tower&yahoo_domain=fr.search.yahoo.com
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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.