Scrapingdog

Yahoo Search Scraper API

The Yahoo Search Scraper API returns Yahoo web search results as structured JSON. Every organic result carries its position, title, destination link, displayed link, source, publish date, snippet and favicon, along with sitelinks where Yahoo shows them — plus top_stories and related_searches when the page carries them.

Endpoint: https://api.scrapingdog.com/yahoo/search

API Parameters

🔑

Scrapingdog Parameters

  • api_key Required
    Your personal API key. Available on your dashboard.

    Type: String
🔍

Search Query

  • query Required
    The search term to look up on Yahoo (e.g., best running shoes). Required unless url is supplied.

    Type: String
  • url Optional
    A full Yahoo search URL to fetch verbatim, instead of building one from the parameters above.

    Type: String
  • page Optional
    Page number, starting at 1.

    Yahoo itself paginates by result offset rather than page number — page 2 is b=11 on Yahoo. This API takes the human page number and converts it for you.

    Default: 1

    Type: Integer
  • results Optional
    Results per page. Yahoo treats this as a hint and usually returns 7–10 regardless of what you ask for.

    Type: Integer
🌍

Localization

  • country Optional
    Two-letter country code. Selects Yahoo’s per-country host, such as in.search.yahoo.com or de.search.yahoo.com.

    The country host localizes the page, but Yahoo also geolocates by the IP the request leaves from, so country=in through a non-Indian exit can still return US results. Pairing country with language is far more reliable — country=de&language=de returns German results consistently.

    Type: String
  • language Optional
    Language code, sent to Yahoo as vl=lang_<code>. Best used alongside country.

    Type: String
🎚

️ Filters

  • time Optional
    Restrict results by age.

    Accepted values: d (past day), w (past week), m (past month).

    Type: String
  • safesearch Optional
    Adult-content filtering, passed through as Yahoo’s vm parameter. r is the value Yahoo’s own strict-search links carry.

    Type: String
⚙

️ Scrapingdog Options

  • html Optional
    Set to true to receive Yahoo’s raw HTML instead of parsed JSON.

    Default: false

    Type: Boolean

API Examples

API result preview
Code to Integrate
curl "https://api.scrapingdog.com/yahoo/search?api_key=APIKEY&query=best+running+shoes&country=us&language=en"
API Response
{
  "organic_results": [
    {
      "position": 1,
      "title": "The 15 Best Running Shoes of 2026, Tested by Runner's World",
      "link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
      "displayed_link": "https://www.runnersworld.com › best-running-shoes",
      "source": "Runner's World",
      "date": "Aug 3, 2026",
      "snippet": "Find the best running shoes of 2026, including Runner's World-tested picks from Adidas, Brooks, New Balance, Nike, Hoka, Asics, and more.",
      "favicon": "https://s.yimg.com/pv/static/search_favicon/images/40x40_runnersworld.png"
    }
  ],
  "related_searches": [
    {
      "query": "best running shoes for men",
      "link": "https://search.yahoo.com/search?p=best+running+shoes+for+men"
    }
  ],
  "top_stories": [
    {
      "position": 1,
      "title": "The 9 Best Running Shoes, According to Podiatrists",
      "link": "https://www.instyle.com/best-running-shoes-8745291",
      "source": "InStyle",
      "date": "2 days ago",
      "thumbnail": "https://s.yimg.com/uu/api/res/1.2/..."
    }
  ]
}