Web Search

curl --request GET \
  --url https://scrapebadger.com/v1/yahoo/search \
  --header 'X-API-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://scrapebadger.com/v1/yahoo/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/yahoo/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/yahoo/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/yahoo/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "query": "<string>",
  "market": "<string>",
  "result_count": 123,
  "results": [
    {
      "position": 123,
      "title": "<string>",
      "url": "<string>",
      "display_url": "<string>",
      "snippet": "<string>"
    }
  ],
  "ads": [
    {
      "position": 123,
      "title": "<string>",
      "url": "<string>",
      "display_url": "<string>",
      "snippet": "<string>"
    }
  ],
  "related_searches": [
    "<string>"
  ]
}

GET

yahoo

Web Search

curl --request GET \
  --url https://scrapebadger.com/v1/yahoo/search \
  --header 'X-API-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://scrapebadger.com/v1/yahoo/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrapebadger.com/v1/yahoo/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://scrapebadger.com/v1/yahoo/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/yahoo/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "query": "<string>",
  "market": "<string>",
  "result_count": 123,
  "results": [
    {
      "position": 123,
      "title": "<string>",
      "url": "<string>",
      "display_url": "<string>",
      "snippet": "<string>"
    }
  ],
  "ads": [
    {
      "position": 123,
      "title": "<string>",
      "url": "<string>",
      "display_url": "<string>",
      "snippet": "<string>"
    }
  ],
  "related_searches": [
    "<string>"
  ]
}

Search Yahoo’s web SERP. Organic results carry the resolved destination URL (Yahoo’s tracking redirect is decoded), display URL and snippet. Credits: 5

Authorization

string

required

Your ScrapeBadger API key.

Query Parameters

string

required

Search keywords, e.g. coffee machine.

string

default:"us"

Yahoo market code (lowercase), e.g. us, uk, de. See /markets.

integer

default:"0"

Zero-based absolute result offset. Yahoo serves 7 organic results per page, so page 2 is offset=7 — see Pagination.

string

One of off, moderate, strict.

Response

string

Echo of the requested query.

string

The market the results were fetched for.

integer

Organic results returned in this response.

SearchResult[]

Organic results.

Show SearchResult

integer

1-based rank within this page.

string

Destination URL — Yahoo’s redirect is resolved.

string

Human-readable URL shown by Yahoo.

string

Ad[]

Ads served for this query, when present.

Show Ad

integer

string

Yahoo’s related query suggestions.

Example

curl "https://scrapebadger.com/v1/yahoo/search?query=coffee+machine&market=uk" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  "https://scrapebadger.com/v1/yahoo/search?" +
    new URLSearchParams({ query: "coffee machine", market: "uk" }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();

import requests

res = requests.get(
    "https://scrapebadger.com/v1/yahoo/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "coffee machine", "market": "uk"},
)
data = res.json()

Response

{
  "query": "coffee machine",
  "market": "uk",
  "result_count": 7,
  "results": [
    {
      "position": 1,
      "title": "The 9 Best Coffee Makers of 2026, Tested & Reviewed",
      "url": "https://www.seriouseats.com/best-coffee-makers-5069325",
      "display_url": "www.seriouseats.com/best-coffee-makers",
      "snippet": "We brewed hundreds of cups to find the best drip coffee makers..."
    }
  ],
  "ads": [
    {
      "position": 1,
      "title": "Coffee Machines - Free Delivery",
      "url": "https://www.example-retailer.com/coffee",
      "display_url": "www.example-retailer.com",
      "snippet": "Shop our range of bean-to-cup machines."
    }
  ],
  "related_searches": ["best coffee machine 2026", "espresso machine", "bean to cup coffee machine"]
}

Pagination

Yahoo serves 7 organic results per page and exposes no page-size parameter. offset is a zero-based absolute result offset — page 2 is offset=7, page 3 is offset=14. Yahoo also reports no total match count on the web SERP, so there is no total_results field here.

Yahoo web search is Bing-syndicated — organic results come from Microsoft’s index. Expect results close to, but not identical to, the Bing API: Yahoo applies its own ranking, ad load and layout on top.

​Authorization

​Query Parameters

​Response

​Example

​Pagination

Authorization

Query Parameters

Response

Example

Pagination