Image Search

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

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

fetch('https://scrapebadger.com/v1/yahoo/images', 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/images",
  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/images"

	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/images")

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>",
      "image_url": "<string>",
      "thumbnail_url": "<string>",
      "source_url": "<string>",
      "source_domain": "<string>",
      "width": 123,
      "height": 123
    }
  ]
}

GET

yahoo

images

Image Search

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

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

fetch('https://scrapebadger.com/v1/yahoo/images', 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/images",
  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/images"

	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/images")

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>",
      "image_url": "<string>",
      "thumbnail_url": "<string>",
      "source_url": "<string>",
      "source_domain": "<string>",
      "width": 123,
      "height": 123
    }
  ]
}

Search Yahoo Images. Each result carries the full-size image URL, a thumbnail, the page the image lives on, and its pixel dimensions. Credits: 5

Authorization

string

required

Your ScrapeBadger API key.

Query Parameters

string

required

Search keywords, e.g. golden retriever.

string

default:"us"

Yahoo market code (lowercase), e.g. us. See /markets. Echoed back — the image vertical is US-hosted, see Page size.

integer

default:"30"

Results to return, 1–100. Trims the rendered grid — see Page size.

Response

string

Echo of the requested query.

string

The market the results were fetched for.

integer

Images returned.

ImageResult[]

Image results.

Show ImageResult

integer

1-based rank.

string

Full-size image URL.

string

Thumbnail URL.

string

The page the image lives on.

string

integer

Full-size width in pixels.

integer

Full-size height in pixels.

Example

curl "https://scrapebadger.com/v1/yahoo/images?query=golden+retriever&count=10" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  "https://scrapebadger.com/v1/yahoo/images?" +
    new URLSearchParams({ query: "golden retriever", count: "10" }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();

import requests

res = requests.get(
    "https://scrapebadger.com/v1/yahoo/images",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "golden retriever", "count": 10},
)
data = res.json()

Response

{
  "query": "golden retriever",
  "market": "us",
  "result_count": 10,
  "results": [
    {
      "position": 1,
      "title": "Golden Retriever Dog Breed Information",
      "image_url": "https://www.akc.org/wp-content/uploads/2017/11/Golden-Retriever.jpg",
      "thumbnail_url": "https://tse1.mm.bing.net/th?id=OIP.abc123",
      "source_url": "https://www.akc.org/dog-breeds/golden-retriever/",
      "source_domain": "akc.org",
      "width": 1920,
      "height": 1080
    }
  ]
}

Page size

Yahoo renders roughly 60 tiles into the first response and has no native page-size parameter, so count trims that list rather than paginating. Asking for more than Yahoo rendered simply returns everything available.The image vertical only exists on images.search.yahoo.com, so results are fetched from that fixed US host regardless of the market you pass; the value is echoed back for consistency.

​Authorization

​Query Parameters

​Response

​Example

​Page size

Authorization

Query Parameters

Response

Example

Page size