curl --request POST \
--url https://api.anysite.io/api/energystar/products/search \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"product_type": "<string>",
"energy_star_partner": "<string>",
"upc": "<string>",
"text": "<string>",
"most_efficient": true,
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
'import requests
url = "https://api.anysite.io/api/energystar/products/search"
payload = {
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"product_type": "<string>",
"energy_star_partner": "<string>",
"upc": "<string>",
"text": "<string>",
"most_efficient": True,
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
count: 75000,
timeout: 300,
brand: '<string>',
model_name: '<string>',
model_number: '<string>',
product_type: '<string>',
energy_star_partner: '<string>',
upc: '<string>',
text: '<string>',
most_efficient: true,
filters: {},
min_values: {},
max_values: {},
sort: '<string>',
order: 'ASC'
})
};
fetch('https://api.anysite.io/api/energystar/products/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://api.anysite.io/api/energystar/products/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'count' => 75000,
'timeout' => 300,
'brand' => '<string>',
'model_name' => '<string>',
'model_number' => '<string>',
'product_type' => '<string>',
'energy_star_partner' => '<string>',
'upc' => '<string>',
'text' => '<string>',
'most_efficient' => true,
'filters' => [
],
'min_values' => [
],
'max_values' => [
],
'sort' => '<string>',
'order' => 'ASC'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/energystar/products/search"
payload := strings.NewReader("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/energystar/products/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/energystar/products/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"@type": "EnergystarProduct",
"product_category": "<string>",
"product_type": "<string>",
"dataset_id": "<string>",
"dataset_name": "<string>",
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"energy_star_model_identifier": "<string>",
"energy_star_partner": "<string>",
"additional_model_information": "<string>",
"upc": "<string>",
"markets": [],
"is_most_efficient": true,
"available_on_market_date": "<string>",
"qualified_date": "<string>",
"certified_date": "<string>",
"attributes": {}
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}/energystar/products/search
Search ENERGY STAR certified products within one certification category. Narrows by brand, model name and number, sub-type, certifying partner, UPC, the market a model is certified for, whether it meets the Most Efficient criteria, free text across the record, and exact or numeric bounds on any of the measured columns the category is certified on. Orders by any of those columns. Returns the full certification record for every match, with the measured performance figures under the programme’s own column names.
Price: 20 credits per 1000 results
⚠️ Common errors: 412: Nothing in that category matched the filters., 422: A column name the chosen product_category does not have. energystar/product_types lists them.
curl --request POST \
--url https://api.anysite.io/api/energystar/products/search \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"product_type": "<string>",
"energy_star_partner": "<string>",
"upc": "<string>",
"text": "<string>",
"most_efficient": true,
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
'import requests
url = "https://api.anysite.io/api/energystar/products/search"
payload = {
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"product_type": "<string>",
"energy_star_partner": "<string>",
"upc": "<string>",
"text": "<string>",
"most_efficient": True,
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
count: 75000,
timeout: 300,
brand: '<string>',
model_name: '<string>',
model_number: '<string>',
product_type: '<string>',
energy_star_partner: '<string>',
upc: '<string>',
text: '<string>',
most_efficient: true,
filters: {},
min_values: {},
max_values: {},
sort: '<string>',
order: 'ASC'
})
};
fetch('https://api.anysite.io/api/energystar/products/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://api.anysite.io/api/energystar/products/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'count' => 75000,
'timeout' => 300,
'brand' => '<string>',
'model_name' => '<string>',
'model_number' => '<string>',
'product_type' => '<string>',
'energy_star_partner' => '<string>',
'upc' => '<string>',
'text' => '<string>',
'most_efficient' => true,
'filters' => [
],
'min_values' => [
],
'max_values' => [
],
'sort' => '<string>',
'order' => 'ASC'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/energystar/products/search"
payload := strings.NewReader("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/energystar/products/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/energystar/products/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_name\": \"<string>\",\n \"model_number\": \"<string>\",\n \"product_type\": \"<string>\",\n \"energy_star_partner\": \"<string>\",\n \"upc\": \"<string>\",\n \"text\": \"<string>\",\n \"most_efficient\": true,\n \"filters\": {},\n \"min_values\": {},\n \"max_values\": {},\n \"sort\": \"<string>\",\n \"order\": \"ASC\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"@type": "EnergystarProduct",
"product_category": "<string>",
"product_type": "<string>",
"dataset_id": "<string>",
"dataset_name": "<string>",
"brand": "<string>",
"model_name": "<string>",
"model_number": "<string>",
"energy_star_model_identifier": "<string>",
"energy_star_partner": "<string>",
"additional_model_information": "<string>",
"upc": "<string>",
"markets": [],
"is_most_efficient": true,
"available_on_market_date": "<string>",
"qualified_date": "<string>",
"certified_date": "<string>",
"attributes": {}
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
API token from the dashboard
Headers
Body
boilers, ceiling_fans, commercial_boilers, commercial_clothes_washers, commercial_coffee_brewers, commercial_dishwashers, commercial_electric_cooktops, commercial_fryers, commercial_griddles, commercial_hot_food_holding_cabinet, commercial_ice_machines, commercial_ovens, commercial_refrigerators_and_freezers, commercial_steam_cookers, commercial_water_heaters, computers_v9_0, data_center_storage_block_i_o, data_center_storage_file_i_o, dehumidifiers, displays, electric_vehicle_supply_equipment_ac_output, electric_vehicle_supply_equipment_dc_output, enterprise_servers, furnaces, geothermal_heat_pumps, heat_pumps, imaging_equipment, laboratory_grade_refrigerators_and_freezers, large_network_equipment, light_commercial_hvac, light_fixtures_downlights, medical_imaging_equipment, pool_pumps, residential_clothes_dryers, residential_clothes_washers, residential_dishwashers, residential_electric_cooking_products, residential_freezers, residential_refrigerators, room_air_cleaners_v3_0, room_air_conditioners, smart_thermostats, storm_windows, telephones, televisions, uninterruptible_power_supplies, vending_machines, ventilating_fans, water_coolers, water_heaters 1 <= x <= 15000020 <= x <= 15001111111United States, Canada, Taiwan, Japan, Switzerland, Europe, Australia, New Zealand Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
1ASC, DESC Response
Successful Response