Yahoo Scout API

GET   /api/v1/search?engine=yahoo_scout

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.

Engine

  • Name
    engine
    Required
    Required
    Description

    Set to yahoo_scout.

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

Response
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=compare+iphone+17+vs+pixel+10+specs
Request
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)
Response
{
  "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

Cards and Top Stories
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=weather+in+chicago+this+weekend
Request
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)
Response
{
  "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

Inline Shopping
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=best+noise+cancelling+headphones+under+200
Request
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)
Response
{
  "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

Inline Images
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=show+me+pictures+of+the+eiffel+tower
Request
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)
Response
{
  "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

Inline Videos
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_scout&q=best+youtube+videos+to+learn+guitar
Request
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)
Response
{
  "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"
    },
    ...
  ]
}