Logo SearchApi

Yahoo Search API Documentation

Yahoo Search API uses /api/v1/search?engine=yahoo API endpoint to scrape real-time results.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Defines the search term for Yahoo Search. You can also use advanced operators supported by Yahoo, such as site:, OR, NOT, or AND to refine your search.

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the Locations API if you need more precise control.

Localization

Filters

  • Name
    safe
    Required
    Optional
    Description

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

    • on Default
    • moderate
    • off

  • Name
    time_period
    Required
    Optional
    Description

    Filters results by date. Predefined values are:

    • any_time Default
    • last_month
    • last_week
    • last_day

  • Name
    allowed_domains
    Required
    Optional
    Description

    Filters results by the domain. You can specify a list of domains separated by a comma, such as bbc.co.uk,spiegel.de. You can also specify top-level domains, such as .io or .com.

  • Name
    strict_match
    Required
    Optional
    Description

    By default, the value is off, meaning strict matching is disabled, and results from queries that have been auto-corrected for spelling errors are included. To exclude these auto-corrected results, set the value to on.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Defines the page index for retrieving search results. Each page contains 7 results.

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.

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).

API Examples

Knowledge Graph

Knowledge Graph
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=steve+jobs
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "steve jobs"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "knowledge_graph": {
    "title": "Steve Jobs",
    "subtitle": "American entrepreneur; co-founder of Apple Inc.",
    "description": "Steven Paul Jobs was an American businessman, inventor, and investor best known for co-founding the technology company Apple Inc. Jobs was also the founder of NeXT and chairman and... Wikipedia",
    "thumbnail": "https://s.yimg.com/fz/api/res/1.2/oc_2JFkwSZj9wdh6tkgA3g--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpdDtoPTEzMDtxPTgwO3c9OTQ-/https://s.yimg.com/zb/imgv1/e69e63e7-3fa1-38bc-8ed5-0fefe04d8bbd/t_500x300",
    "website": "https://shopping.yahoo.com/rdlw?siteId=us-search&pageId=pc-kg&custData=eyJzb3VyY2VOYW1lIjoiV2ViLURlc2t0b3AtVmVyaXpvbiIsImxhbmRpbmdVcmwiOiJodHRwczovL3d3dy5hcHBsZS5jb20vc3RldmVqb2JzLyIsInJlcXVlc3RJZCI6IjM2ZGkwNzVqbGs3bzIiLCJvcmlnaW5hbFVybCI6Imh0dHBzOi8vd3d3LmFwcGxlLmNvbS9zdGV2ZWpvYnMvIn0&signature=AQAAAeDq4ooxSZGcbIqMTXwOovSMlt6RRBPF1V5-EWFSUH2C&locale=en-US&affiliateRoutingRule=vampireV3&clickFrom=yahoo&spaceId=2766679&uuid=46541a19-4375-4f5b-a361-65888ea0486d&viewId=C1YL6grhcuoIx8ymOJZAyJsmRhFq8gDcEVUABWQh",
    "source": "http://en.wikipedia.org/wiki/Steve_Jobs",
    "born": "February 24, 1955, San Francisco, California, United States",
    "born_links": [
      {
        "text": "San Francisco, California, United States",
        "link": "https://search.yahoo.com/search;_ylt=AwrhcuoCH1pnDQIA87tXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?vs=&vm=r&b=0&p=San+Francisco%2C+California%2C+United+States&fr2=p%3As%2Cv%3Asbsrp%2Cm%3AsbBio&fr=sfp"
      }
    ],
    "died": "October 5, 2011, Palo Alto, California, United States",
    "died_links": [...],
    ...
    "profiles": [
      {
        "name": "Wiki",
        "link": "https://en.wikipedia.org/wiki/Steve_Jobs"
      },
      ...
    ],
    "people_also_search_for": [
      {
        "query": "Steve Wozniak",
        "link": "https://search.yahoo.com/search;_ylt=AwrhcuoCH1pnDQIAB7xXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?vs=&vm=r&p=Steve+Wozniak&d=%7B%22domain%22%3A%22businessperson%22%2C%22type%22%3A%22yk%22%2C%22id%22%3A%228784534d-5696-463d-abaa-66f54a7a86b3%22%7D&fr2=p%3As%2Cv%3Aw%2Cm%3Akg-pasf%2Cct%3AGetPersonInfo&fr=sfp",
        "thumbnail": "https://s.yimg.com/fz/api/res/1.2/ATrrheww4ftv4PqIfAp3QA--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0xMjA7cT04MDt3PTEyMA--/https://s.yimg.com/zb/imgv1/86094b79-3f39-38f6-aef6-3688f1f03e57/s_140x140"
      },
      ...
    ]
  }
}

Answer Box

Answer Box
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=how+old+is+elon+musk%3F
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "how old is elon musk?"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "answer_box": {
    "type": "core_answer",
    "answer": "Elon Musk Age: 53 years",
    "thumbnail": "https://s.yimg.com/fz/api/res/1.2/a4Ok9bK_frNbki3pSPAEww--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpdDtoPTI1MjtxPTgwO3c9MjUy/https://s.yimg.com/zb/imgv1/927f7f57-ef17-3a8b-add5-09d2d2908d88/t_140x140"
  }
}

Local Results

Local Results
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&location=New+Jersey&q=restaurants+near+me
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "restaurants near me",
  "location": "New Jersey"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "local_results": [
    {
      "position": 1,
      "title": "Brooklyn Square Pizza",
      "link": "https://search.yahoo.com/local/s;_ylt=AwrEpgbVRFtnnwIA3bdXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?vs=&radius=21.6&lon=-74.4056612&b=0&locupdate=1&vm=r&lat=40.0583238&p=restaurants+near+me&selectedId=153158968&fr=sfp",
      "type": "Pizza",
      "rating": 4,
      "reviews": 465,
      "reviews_source": "465 on Yelp",
      "price": "$$",
      "address": "265 S New Prospect Rd, Jackson, NJ",
      "phone": "(732) 961-7999",
      "order": "https://www.slicelife.com/restaurants/nj/jackson/08527/brooklyn-square-pizza-inc/menu/?utm_source=yahoo",
      "website": "https://www.brooklynsquarenj.com/",
      "menu": "https://slicelife.com/restaurants/nj/jackson/08527/brooklyn-square-pizza-inc/menu/?utm_source=yahoo",
      "extensions": [
        "Pickup",
        "Delivery"
      ],
      "image": "https://s.yimg.com/fz/api/res/1.2/K1.JnyLaPRyJpMYs21tOzA--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0xODA7cT04MDt3PTE4MA--/https://s.yimg.com/bj/e52c/e52c4e7dea3b800bd90a103542a0349e.jpg"
    },
    ...
  ]
}

Organic Results (With Articles)

Organic Results (With Articles)
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=airbnb
Request
import requests

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "title": "Airbnb | Vacation rentals, cabins, beach houses, & more",
      "link": "https://www.airbnb.com/",
      "displayed_link": "www.airbnb.com",
      "snippet": "Get an Airbnb for every kind of trip → 7 million vacation rentals → 2 million Guest Favorites → 220+ countries and regions worldwide",
      "snippet_highlighted_words": [
        "Airbnb"
      ],
      "sitelinks": {
        "expanded": [
          {
            "title": "Log In",
            "link": "https://www.airbnb.com/login",
            "snippet": "Join a global community of travelers and local hosts on... Host Your Home Reston Disability support United States",
            "inline_links": [
              {
                "text": "Host Your Home",
                "link": "https://www.airbnb.com/host/homes"
              },
              ...
            ]
          },
          ...
        ]
      },
      "rich_snippet": {
        "detected_extensions": {
          "articles": [
            {
              "title": "Airbnb your place",
              "link": "https://www.airbnb.com/host/homes",
              "thumbnail": "https://sp.yimg.com/ib/th?&id=ODL.9725b05f058afd6fed9284692d49a4f8&w=220&h=143&c=4&rs=1"
            },
            ...
          ]
        }
      },
      "favicon": "https://s.yimg.com/cv/apiv2/search/favicon/32x32_77cbce8bb0bd0468735ba38f490be626.png"
    },
    {
      "position": 2,
      "title": "United States Vacation Rentals | Cottage and ... - Airbnb",
      "link": "https://www.airbnb.com/united-states/stays",
      "snippet": "Find the perfect vacation rental for your trip to United States. Beach vacation rentals and private vacation rentals await you on Airbnb.",
      "snippet_highlighted_words": [
        "Airbnb"
      ],
      "images": [
        "https://sp.yimg.com/ib/th?id=OIP.r6Y2J6mVL7MlleMXWITgXwHaE8&pid=Api&w=148&h=148&c=7&rs=1",
        ...
      ],
      "favicon": "https://s.yimg.com/cv/apiv2/search/favicon/32x32_77cbce8bb0bd0468735ba38f490be626.png"
    },
    ...
  ]
}

Organic Results (Tabbed Snippets)

Organic Results (Tabbed Snippets)
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=vpn
Request
import requests

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "title": "Free VPN Download - Get the fastest VPN app - NordVPN",
      "link": "https://nordvpn.com/download/",
      "displayed_link": "www.nordvpn.com › download",
      "tabbed_snippets": [
        {
          "title": "Overview",
          "snippet": "This article is about NordVPN, a virtual private network service that encrypts internet traffic to protect online identity and data from third parties. It offers enhanced privacy, security, protection against cyber threats, fast speed with over 5400 VPN servers in 60 countries and the ability to connect up to 6 devices with a single account."
        },
        
      ],
      "favicon": "https://s.yimg.com/cv/apiv2/search/favicon/32x32_322367b9334085b76718966fb49a80e6.png"
    },
    ...
  ]
}

Ads

Ads
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=vpn
Request
import requests

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "ads": [
    {
      "position": 1,
      "block_position": "top",
      "title": "Updated VPN Comparison - Compare Now & Save Up To 84%",
      "link": "https://www.vpnmentor.com/best-vpn-for-canada?keyword=vpn&geo=5254&device=&utm_source=bing&adid=76416208734825&msclkid=daecf95aa5921ece6bb39e0318b8439e",
      "displayed_link": "www.vpnmentor.com",
      "snippet": "7 Best Free VPN Services For All Needs. Compare Now & Get Unlimited Bandwidth. Start Today. These VPNs are Not Only Free, But Super Fast & Easy to Use. Find Which One is Best For You",
      "sitelinks": {
        "inline": [
          {
            "title": "Top 7 Best VPNs of 2024",
            "link": "https://www.vpnmentor.com/greatvpn/?keyword=vpn&geo=5254&device=&utm_source=bing&adid=76416208734825&msclkid=796ed51420a51aceebf0b24d9d8f5151"
          },
          ...
        ]
      },
      "assets": {
        "prices": [
          {
            "title": "ExpresVPN: 15 Months",
            "price": "$6.67/month",
            "extracted_price": 6.67,
            "link": "https://www.vpnmentor.com/reviews/expressvpn?keyword=vpn&geo=5254&device=&utm_source=bing&adid=76416208734825&msclkid=5260e8b6e6891f27d7b68fef5ba31d2e"
          },
          ...
        ],
        "structured_snippet": {
          "title": "Types",
          "text": "VPN Routers, Privacy Policy, NordVPN, Dedicated IP and more"
        },
        "promotion": {
          "title": "Cyber Monday: Up to 61% off 2 year plan VPN",
          "link": "https://www.vpnmentor.com/best-vpns-for-cyber-monday/?keyword=vpn&geo=5254&device=&utm_source=bing&adid=76416208734825&msclkid=35b5851eaaad187caedee24717872e27"
        },
        "extensions": [
          "Bypass GEO Blocks Easy",
          ...
        ]
      },
      "favicon": "https://up.yimg.com/ib/th?id=OADD2.8589956516195_1KS7D6RSKP15P4UHHX&pid=21.2&w=16&c=1&rs=1&qlt=95"
    },
    ...
    {
      "position": 9,
      "block_position": "right_top",
      "title": "Top 7 Best Free VPN Jan 2024",
      "link": "https://www.vpnmentor.com/best-free-vpn-trials/?keyword=vpn&geo=5254&device=&utm_source=bing&adid=76416224406347&msclkid=74138062c047151cf7b6e73b7d6dd22b",
      "displayed_link": "www.vpnmentor.com",
      "snippet": "Compare & Choose VPN. Money Back Guarantee. 7670 Servers In 90 Countries.",
      "favicon": "https://sp.yimg.com/ib/th?id=OADD2.7902768903418_122AWKT8SKUO1ZSB0P&pid=21.2&c=16&roil=0&roit=0.1079&roir=1&roib=0.8936&w=442&h=231"
    }
  ]
}

Inline Images

Inline Images
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=koala
Request
import requests

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_images": [
    {
      "title": "Koala | Appearance, Diet, Habitat, & Facts | Britannica",
      "source": {
        "name": "www.britannica.com",
        "link": "https://www.britannica.com/animal/koala"
      },
      "original": {
        "link": "https://cdn.britannica.com/26/162626-050-3534626F/Koala.jpg",
        "height": 1600,
        "width": 1279,
        "size": "312KB"
      },
      "thumbnail": "https://tse1.mm.bing.net/th?id=OIP.ghtqPTFcLzNzq_C-8zfa2QHaJQ&pid=Api"
    },
    ...
  ]
}

Inline Videos

Inline Videos
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=jokic
Request
import requests

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_videos": [
    {
      "position": 1,
      "title": "Nikola Jokic's Best Plays From The Season! 🃏",
      "link": "https://www.youtube.com/watch?v=40iv5pZXIzo",
      "source": "YouTube",
      "date": "May 22, 2021",
      "views": "276K Views",
      "length": "15:14",
      "image": "https://up.yimg.com/ib/th?id=OVP.NrfFUUGc9ZTmFpj2uAwlogEsDh&pid=Api&w=296&h=156&c=7&p=0&rs=1&qlt=95"
    },
    ...
  ]
}

Related Questions

Related Questions
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=how+to+convert+video+into+text
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "how to convert video into text"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "related_questions": [
    {
      "question": "How do I convert a video to text?",
      "answer": "You first need to record a video using the Stories/Reels Camera or select a video you've already recorded that's in your gallery. Swipe up to open the sticker tray and select the ‘Captions’ sticker. You should then see that the speech on your video is being converted into text on the screen.",
      "source": {
        "title": "Instagram now lets you add captions to Stories that turns",
        "link": "https://www.thesun.co.uk/tech/14860600/how-to-put-captions-on-instagram-stories/"
      }
    },
    ...
  ]
}

Top Stories

Top Stories
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=champions+league
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "champions league"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "top_stories": [
    {
      "title": "Which teams can qualify for the Champions League last 16? How do things stand?",
      "link": "https://www.msn.com/en-us/sports/soccer/which-teams-can-qualify-for-the-champions-league-last-16-how-do-things-stand/ar-AA1vJ5aW",
      "source": "NBC Sports on MSN.com",
      "date": "2 hours ago",
      "snippet": "Here's everything you need to know about the situation for all 36 teams in the UEFA Champions League league phase.",
      "thumbnail": "https://up.yimg.com/ib/th?id=OVFT.tT0t4V94TJI6PVakQmnSGy&pid=News&w=576&h=384&c=14&qlt=90&rs=1"
    },
    ...
  ]
}

Trending Searches

Trending Searches
GET
https://www.searchapi.io/api/v1/search?engine=yahoo&q=todays+news
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "yahoo",
  "q": "todays news"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "trending_searches": [
    {
      "title": "New Jersey Drone Sightings",
      "snippet": "New Jersey drone swarm spotted coming in 'off the ocean'",
      "link": "https://search.yahoo.com/search;_ylt=AwrFOJCrv1pnfQIACgxXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?vm=r&vs=&p=New+Jersey+Drone+Sightings&fr2=p%3As%2Cv%3Aw%2Cm%3Atn%2Cct%3Aall%2Cpg%3A1%2Cstl%3Atxt%2Ckt%3Aorg%2Cb%3A&fr=sfp",
      "thumbnail": "https://s.yimg.com/fz/api/res/1.2/VxtKiofc657wfIXNQycpvQ--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05NjtxPTgwO3NtPTE7dz05Ng--/https://media.zenfs.com/en/usa_today_money_325/2e307e743712375d37d1654ca1198aa2"
    },
    ...
  ]
}