/energystar/products/most_efficient
curl --request POST \
--url https://api.anysite.io/api/energystar/products/most_efficient \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_number": "<string>",
"text": "<string>",
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
'import requests
url = "https://api.anysite.io/api/energystar/products/most_efficient"
payload = {
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_number": "<string>",
"text": "<string>",
"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_number: '<string>',
text: '<string>',
filters: {},
min_values: {},
max_values: {},
sort: '<string>',
order: 'ASC'
})
};
fetch('https://api.anysite.io/api/energystar/products/most_efficient', 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/most_efficient",
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_number' => '<string>',
'text' => '<string>',
'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/most_efficient"
payload := strings.NewReader("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_number\": \"<string>\",\n \"text\": \"<string>\",\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/most_efficient")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_number\": \"<string>\",\n \"text\": \"<string>\",\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/most_efficient")
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_number\": \"<string>\",\n \"text\": \"<string>\",\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
/energystar/products/most_efficient
Read an ENERGY STAR Most Efficient list — the annual shortlist of the best-performing certified models in a category, a stricter bar than ENERGY STAR certification itself. Returns the same full certification record as the product search, and takes the same brand, model number, market, free-text, exact-match and numeric-bound filters over the category’s measured columns.
Price: 20 credits per 1000 results
⚠️ Common errors: 412: That Most Efficient list is empty for the current cycle, or nothing in it matched the filters., 422: A column name the underlying category does not have.
POST
/
api
/
energystar
/
products
/
most_efficient
/energystar/products/most_efficient
curl --request POST \
--url https://api.anysite.io/api/energystar/products/most_efficient \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_number": "<string>",
"text": "<string>",
"filters": {},
"min_values": {},
"max_values": {},
"sort": "<string>",
"order": "ASC"
}
'import requests
url = "https://api.anysite.io/api/energystar/products/most_efficient"
payload = {
"count": 75000,
"timeout": 300,
"brand": "<string>",
"model_number": "<string>",
"text": "<string>",
"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_number: '<string>',
text: '<string>',
filters: {},
min_values: {},
max_values: {},
sort: '<string>',
order: 'ASC'
})
};
fetch('https://api.anysite.io/api/energystar/products/most_efficient', 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/most_efficient",
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_number' => '<string>',
'text' => '<string>',
'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/most_efficient"
payload := strings.NewReader("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_number\": \"<string>\",\n \"text\": \"<string>\",\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/most_efficient")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"count\": 75000,\n \"timeout\": 300,\n \"brand\": \"<string>\",\n \"model_number\": \"<string>\",\n \"text\": \"<string>\",\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/most_efficient")
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_number\": \"<string>\",\n \"text\": \"<string>\",\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
application/json
Available options:
air_source_heat_pumps, ceiling_fans, clothes_dryers, clothes_washers, dehumidifiers, dishwashers, displays, ducted_heat_pumps, geothermal_heat_pumps, mini_split_heat_pumps, residential_freezers, residential_refrigerators, room_air_cleaners, room_air_conditioners, ventilating_fans Required range:
1 <= x <= 150000Required range:
20 <= x <= 1500Minimum string length:
1Minimum string length:
1Minimum string length:
1Available options:
United 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
Minimum string length:
1Available options:
ASC, DESC Response
Successful Response