Search listings

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

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

fetch('https://scrapebadger.com/v1/etsy/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/etsy/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/etsy/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/etsy/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

GET

etsy

Search listings

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

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

fetch('https://scrapebadger.com/v1/etsy/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/etsy/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/etsy/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/etsy/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

Search listings. Credits: 10 per successful request. Failed requests and empty result sets are not charged.

Authentication

string

required

Your ScrapeBadger API key.

Parameters

string

required

Query. Minimum length: 1. Maximum length: 250.

integer

default:"1"

Page. Minimum: 1. Maximum: 250.

string

default:"US"

Country.

string

default:"USD"

Currency.

string

default:"en-US"

Language.

string

default:"most_relevant"

Sort. Allowed values: most_relevant, date_desc, price_asc, price_desc.

number

Min price. Minimum: 0.

number

Max price. Minimum: 0.

Response

{
  "items": [
    {
      "listing_id": "1510223855",
      "title": "The Libby Travel Mug hand thrown ceramic mug cup Pottery Travel Mug Cup with attached lid fits in cup holder",
      "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic",
      "description": null,
      "price": 34.99,
      "original_price": null,
      "currency": "USD",
      "availability": "https://schema.org/InStock",
      "quantity": null,
      "category": null,
      "images": [
        "https://i.etsystatic.com/8740835/r/il/d4f720/7239142492/il_fullxfull.7239142492_oym6.jpg"
      ],
      "image_details": [],
      "shop_name": "StonehousePotteryOH",
      "shop_id": "8740835",
      "shop_url": "https://www.etsy.com/shop/StonehousePotteryOH",
      "rating": 4.9,
      "review_count": 169,
      "is_ad": false,
      "shipping": null,
      "variations": [],
      "breadcrumbs": [],
      "videos": []
    }
  ],
  "total_results": 1403318,
  "locale": {
    "language": {
      "code": "en-US",
      "id": 0,
      "name": "English (US)",
      "translation": "English (US)",
      "is_detected": false,
      "is_default": true
    },
    "currency": {
      "currency_id": 840,
      "code": "USD",
      "name": "United States Dollar",
      "number_precision": 2,
      "symbol": "$",
      "listing_enabled": true,
      "browsing_enabled": true,
      "buyer_location_restricted": false,
      "is_synthetic": true,
      "is_detected": false,
      "is_default": true,
      "append_currency_symbol": false
    },
    "region": {
      "code": "US",
      "country_id": 209,
      "name": "United States",
      "translation": "United States",
      "is_detected": false,
      "is_default": true,
      "is_EU_region": false
    },
    "subdir_code": ""
  },
  "next_page": 2,
  "query": "ceramic mug",
  "page": 1
}

Example

curl --get 'https://scrapebadger.com/v1/etsy/search' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'query=ceramic mug'

Browse all Etsy endpoints.

​Authentication

​Parameters

​Response

​Example

Authentication

Parameters

Response

Example