Yahoo Scout API
Send a question to the yahoo_scout engine to receive a structured answer. Text answers include Markdown and text blocks. Additional result collections depend on the source answer.
To continue an answer, pass pagination.conversation_token with the next question. Keep the same country for the conversation. Search results and cards depend on the question and the answer provided by Yahoo Scout.
Sports standings include games_behind, the current streak, and last_10_record for the team’s most recent games.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
The question to send to Yahoo Scout, up to 10000 characters. The limit counts UTF-16 code units; a supplementary character such as an emoji counts as two.
Localization
-
- Name
-
country - Required
- Optional
- Description
-
The country for the answer. The default parameter is
us. Keep the same country when continuing a conversation. Supported values:us,gb,uk.
Conversation
-
- Name
-
conversation_token - Required
- Optional
- Description
-
Use pagination.conversation_token from a fresh response to continue the conversation. Up to 2048 characters.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
Your SearchAPI API key. You can also use the Authorization: Bearer header.
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set to true to disable persistent storage and request logging.
Response
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=compare+iphone+17+vs+pixel+10+specs
- 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_scout",
"q": "compare iphone 17 vs pixel 10 specs"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_6EB5K71e3vjbf7MR3vXNW82V",
"status": "Success",
"created_at": "2026-11-05T17:07:05Z",
"request_time_taken": 17.81,
"parsing_time_taken": 0.01,
"total_time_taken": 17.82,
"request_url": "https://scout.yahoo.com/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_6EB5K71e3vjbf7MR3vXNW82V.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_6EB5K71e3vjbf7MR3vXNW82V"
},
"search_parameters": {
"engine": "yahoo_scout",
"q": "compare iphone 17 vs pixel 10 specs",
"country": "us"
},
"text_blocks": [
{
"type": "paragraph",
"answer": "The Apple iPhone 17 and Google Pixel 10 represent distinct approaches to hardware and software, with the iPhone 17 operating on the Apple A19 chipset and the Pixel 10 utilizing the Google Tensor G5 processor. While both devices feature 6.3-inch displays, they differ significantly in battery life and...",
"reference_indexes": [
0,
...
]
},
...
],
"markdown": "The Apple iPhone 17 and Google Pixel 10 represent distinct approaches to hardware and software, with the iPhone 17 operating on the Apple A19 chipset and the Pixel 10 utilizing the Google Tensor G5 processor. While both devices feature 6.3-inch displays, they differ significantly in battery life and...",
"reference_links": [
{
"index": 0,
"title": "iPhone 17 vs Google Pixel 10 Pro: Which should you buy in 2026?",
"link": "https://www.trustedreviews.com/versus/iphone-17-vs-google-pixel-10-pro",
"source": "trustedreviews.com",
"snippet": "Keep reading to see how the iPhone 17 compares to the Pixel 10 Pro. If you’re not sold on either, make sure you visit our best smartphones guide, where we’ve li..."
},
...
],
"citations": [
{
"index": 39,
"source_indexes": [
0
],
"cited_text": "Apple iPhone 17 and Google Pixel 10"
},
...
],
"web_results": [
{
"position": 1,
"title": "Compare Apple iPhone 17 vs. Google Pixel 10 - GSMArena.com",
"link": "https://www.gsmarena.com/compare.php3?idPhone1=14050&idPhone2=13979",
"source": "gsmarena.com",
"snippet": "Compare Apple iPhone 17 vs. Google Pixel 10 - GSMArena.com Compare specs Phone finder All brands Rumor mill Full Differences Change compare mode Compare with Ap..."
},
...
],
"shopping_ads": [
{
"position": 1,
"block_position": "top_carousel",
"product_id": "B0FFSRDTPP",
"title": "TISENPET USB C to USB C Cable 3FT 60W, 2-Pack Charger Cord for iPhone 18 17 | Woven Type C Charger Fast Charging Cord for iPhone 18/17/16/15 Pro Max iPad Pro Ai...",
"link": "https://www.amazon.com/dp/B0FFSRDTPP",
"tracking_link": "https://www.amazon.com/dp/B0FFSRDTPP?aaxitk=579c5be61b9067e2150a2a4a08ceb93b&aref=V5xb5huQZ-&tqtoken...",
"extracted_price": 9.99,
"currency": "USD",
"rating": 4.4,
"reviews": 141,
"description": "This 3-foot USB-C to USB-C cable features double-braided nylon construction and supports 60W fast charging with 480Mbps data transfer speeds. Compatible with iP...",
"thumbnail": "https://s.yimg.com/lo/mysterio/api/88d557711328ee369ec1ee4c77ca58460964bbbad61ed90dccfe1c2b72ee5819/...",
"seller": "amazon"
},
...
],
"ads": [
{
"position": 1,
"title": "iPhone 17e | Apple Official Site | Genmoji",
"link": "https://www.apple.com/us/shop/go/iphone_17e/?cid=wwa-us-kwbi-iphone-noncore_iphone17e-iphone17e_ai-i...",
"tracking_link": "https://www.bing.com/aclick?ld=e8HPLcH-rFZtmKoE25j2LOpjVUCUzrG0pC0Qj_-UpH2Em6Us7SQJKbpkB5maPIExbViIe...",
"displayed_link": "www.apple.com",
"snippet": "iOS and Apple Intelligence. Effortlessly helpful every day. Apple. Your one-stop shop for incredible carrier deals from AT&T, Verizon, or T-Mobile."
}
],
"related_questions": [
{
"question": "What are the expected camera sensor upgrades for iPhone 17 and Pixel 10?"
},
...
],
"response_metadata": {
"model": "bedrock.haiku-4-5",
"conversation_id": "01a1acad-943a-7480-881f-49be3b5ba7d6-a",
"message_id": "01a1acad-9b05-73e2-86ec-25c71f7bab9f",
"title": "iPhone 17 vs Pixel 10 specs",
"intent": "shopping",
"is_web_search_performed": true,
"has_warning": false
},
"pagination": {
"conversation_token": "eyJmbG93X2lkIjoiMDFhMWFjYWQtOTQzYS03NDgwLTg4MWYtNDliZTNiNWJhN2Q2LWEiLCJtb2RlbCI6ImJlZHJvY2suaGFpa3UtNC01IiwiY291bnRyeSI6InVzIiwic2Vzc2lvbiI6IlVFY1FCMmkxZ2pBcktZWVlMMXVVaFl1alRRWmc1RzRpcFVHWHVyTE1Rci8reE5meVRucXFydHp3eUhHUXU1Z29DTXlBb3ZsRmdaenRiaktwWjA2ZlZMRkc2ckhPVTY1Tk9HeDhOcHhPUk1hdVFPdEkvZ0VEWkxyNmsrUVZIY3RYZGJxb2kzUGhXTHBGT1hOZ3o1eFUvd2FoelZML0dNZlRiOGkrREYrL3RxTFRMVGU3RWdsdnA2N1lWcEx2c3hJKyt1YmljK1FUWjhDNFplMHpNczJlSThHWkxQOFozSUxscTVZejhOVkkycENTdStuQ05iaFpzd003QitlZmFyOHl5R0ZxUk4rb1BTeTl6WHBYbldHVmJMRTBVdE10UVJlUk5YWWtRbmUzWmZCcVBRbUxjZHJ0VVNVQ2RHQktJWjh4YllhZDluMG5sYkR3c0d5a3M3WFRJeElOeTFrYmlzSlNzTTJzSUVLQXAzaXRYQjVtMDBHNU42YkdTdzBqME1JUzFwbmZ5ZW5icW44bXhSRURtUW5BREM4NVJ2b2RhY29aVThOZ092WlZ0a3VjN3BENTVPdE1JRzIzNS85WGcvSWRoSW9YM0FSMm1kR2lNYkJSRTVZMS9RSnNNV1RlVlR4eXdLa1hSR2FVcDJKOHNQcjRQOEQ1ZnUvZUpudHNnUS9QMFo3a0RNZHZ6V0dGL2ltcmNvOG04ZE90cDYwd3E1SGZSbDBMZzlMSjlaaHY5RTNrNHJEYy9vUVJkZDV5ZEFJQWxBPT0tLVk0eTdxWWJ3aHhEQThYWFotLVR4RWk5QW8wNzgrUDNZQTZhNVcxREE9PSJ9"
}
}
Cards and Top Stories
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=weather+in+chicago+this+weekend
- 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_scout",
"q": "weather in chicago this weekend"
}
response = requests.get(url, params=params)
print(response.text)
{
"cards": [
{
"type": "weather",
"source": {
"name": "Yahoo Weather",
"link": "https://weather.yahoo.com/united-states/illinois/chicago-2379574"
},
"location": "Chicago",
"region": "IL",
"timezone": "America/Chicago",
"current": {
"temperature": 56,
"unit": "F",
"condition": "Rain",
"condition_icon": "12",
"humidity": 74,
"uv_index": 1,
"wind_speed": 2,
"pressure": 29.819393,
"precipitation_chance": 49,
"air_quality": {
"aqi": 49,
"description": "Moderate"
},
"moon_phase": "Waxing Crescent"
},
"forecast": [
{
"date": "2026-11-11",
"day_of_week": "Wednesday",
"high": 52,
"low": 36,
"condition": "Showers",
"condition_icon": "11",
"uv_index": 1,
"sunrise": "6:36 AM",
"sunset": "4:33 PM",
"moon_phase": "Waxing Crescent",
"hourly": [
{
"time": "2026-11-11 12:00",
"temperature": 55,
"precipitation_chance": 49,
"wind_speed": 7
},
...
]
},
...
]
},
...
],
"top_stories": [
...,
{
"position": 3,
"id": "3caa0617-4701-35f6-aab7-ca6234581582",
"title": "Chicago Boomers Are Moving To This Midwestern State With Vibrant Cities And Iconic Craft Brews",
"link": "https://www.yahoo.com/lifestyle/articles/chicago-boomers-moving-midwestern-state-140000114.html",
"source": "Islands via Yahoo News",
"date": "3 hours ago",
"iso_date": "2026-11-11T14:00:00Z",
"snippet": "A nearby Midwestern state leads destinations for Chicago boomers, offering smaller-city living, cultural attractions, breweries, and outdoor recreation.",
"thumbnail": "https://s.yimg.com/lo/mysterio/api/f95a513d6071ba667bc56281e07ad00253406135b7214b812283eb52d84d0ead/scout/quality_80;smartcrop_w520_h240_faces/https://media.zenfs.com/en/islands_423/7ed5b6ee5e7b995211dfa8c6b45a0611.jpg"
},
...
]
}
Inline Shopping
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=best+noise+cancelling+headphones+under+200
- 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_scout",
"q": "best noise cancelling headphones under 200"
}
response = requests.get(url, params=params)
print(response.text)
{
"inline_shopping": [
{
"position": 1,
"title": "Sennheiser Momentum 4 Wireless",
"link": "https://www.bestbuy.com/product/sennheiser-momemtum-4-wireless-adaptive-noise-canceling-over-the-ear...",
"price": "$199.99",
"extracted_price": 199.99,
"rating": 4.5,
"reviews": 1650,
"seller": "Best Buy",
"domain": "bestbuy.com",
"description": "This option is perfect for users who need extended listening times with ANC, offering an impressive 60 hours of battery life, combined with great sound quality.",
"thumbnail": "https://s.yimg.com/lo/mysterio/api/725015f75ac4461e7f0376d9dd34aa58cde1b6fc277c1e4c13074a635aeae8a4/..."
},
...
]
}
Inline Images
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=show+me+pictures+of+the+eiffel+tower
- 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_scout",
"q": "show me pictures of the eiffel tower"
}
response = requests.get(url, params=params)
print(response.text)
{
"inline_images": [
{
"title": "You Can T Take Pictures Of The Eiffel Tower At Night at Colin Jetton blog",
"link": "https://storage.googleapis.com/dvutelnibhhhye/you-can-t-take-pictures-of-the-eiffel-tower-at-night.h...",
"thumbnail": "https://up.yimg.com/ib/th/id/OIP.EcrM0DyXZOHikflWxYxyRQHaHa?pid=Api&c=1&rs=1&qlt=95&w=360&h=360",
"original": "https://th-thumbnailer.cdn-si-edu.com/BfFer0B0tVO5c7Y8f0Hp7MMKxGQ=/800x800/https://tf-cmsv2-smithson...",
"width": 800,
"height": 800
},
...
]
}
Inline Videos
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=best+youtube+videos+to+learn+guitar
- 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_scout",
"q": "best youtube videos to learn guitar"
}
response = requests.get(url, params=params)
print(response.text)
{
"inline_videos": [
{
"position": 1,
"title": "Guitar Lesson 1 - Absolute Beginner? Start Here! [Free 10 Day Starter Course]",
"link": "https://www.youtube.com/watch?v=BBz-Jyr23M4",
"source": "YouTube",
"duration": "16:11",
"date": "2016-09-02",
"thumbnail": "https://up.yimg.com/ib/th/id/OVP.MUsIj3QUeejRJoOKaOIKQgHgFo?pid=Api&c=1&rs=1&qlt=95&w=430"
},
...
]
}