Web Search
curl --request GET \
--url https://scrapebadger.com/v1/yahoo/search \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/yahoo/search"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/yahoo/search")
.header("X-API-Key", "<x-api-key>")
.asString();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
Web Search
Search the Yahoo web SERP — organic results, ads and related searches.
GET
/
v1
/
yahoo
/
search
Web Search
curl --request GET \
--url https://scrapebadger.com/v1/yahoo/search \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/yahoo/search"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/yahoo/search")
.header("X-API-Key", "<x-api-key>")
.asString();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.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[]
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.

