> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /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.



## OpenAPI

````yaml /openapi/gov-public-sector.json post /api/energystar/products/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/energystar/products/search:
    post:
      tags:
        - /energystar
      summary: /energystar/products/search
      description: >-
        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.
      operationId: __api_energystar_products_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnergystarProductsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EnergystarProduct'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EnergystarProductsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        product_category:
          $ref: '#/components/schemas/EnergystarProductCategory'
        brand:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        model_name:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        model_number:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        product_type:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        energy_star_partner:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        upc:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        text:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        market:
          anyOf:
            - $ref: '#/components/schemas/EnergystarMarket'
            - type: 'null'
        most_efficient:
          anyOf:
            - type: boolean
            - type: 'null'
        filters:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
        min_values:
          anyOf:
            - additionalProperties:
                type: number
              type: object
            - type: 'null'
        max_values:
          anyOf:
            - additionalProperties:
                type: number
              type: object
            - type: 'null'
        sort:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
        order:
          $ref: '#/components/schemas/EnergystarSortOrder'
          default: ASC
        count:
          type: integer
          maximum: 150000
          minimum: 1
      type: object
      required:
        - product_category
        - count
    EnergystarProduct:
      properties:
        '@type':
          type: string
          default: EnergystarProduct
        id:
          type: string
        product_category:
          anyOf:
            - type: string
            - type: 'null'
        product_type:
          anyOf:
            - type: string
            - type: 'null'
        dataset_id:
          anyOf:
            - type: string
            - type: 'null'
        dataset_name:
          anyOf:
            - type: string
            - type: 'null'
        brand:
          anyOf:
            - type: string
            - type: 'null'
        model_name:
          anyOf:
            - type: string
            - type: 'null'
        model_number:
          anyOf:
            - type: string
            - type: 'null'
        energy_star_model_identifier:
          anyOf:
            - type: string
            - type: 'null'
        energy_star_partner:
          anyOf:
            - type: string
            - type: 'null'
        additional_model_information:
          anyOf:
            - type: string
            - type: 'null'
        upc:
          anyOf:
            - type: string
            - type: 'null'
        markets:
          items:
            type: string
          type: array
          default: []
        is_most_efficient:
          anyOf:
            - type: boolean
            - type: 'null'
        available_on_market_date:
          anyOf:
            - type: string
            - type: 'null'
        qualified_date:
          anyOf:
            - type: string
            - type: 'null'
        certified_date:
          anyOf:
            - type: string
            - type: 'null'
        attributes:
          additionalProperties: true
          type: object
          default: {}
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    EnergystarProductCategory:
      type: string
      enum:
        - 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
    EnergystarMarket:
      type: string
      enum:
        - United States
        - Canada
        - Taiwan
        - Japan
        - Switzerland
        - Europe
        - Australia
        - New Zealand
    EnergystarSortOrder:
      type: string
      enum:
        - ASC
        - DESC
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````