Skip to main content
SolarQna
V1Developer Portal · Machine Data Interface

SolarQna Public REST API v1

Direct machine access to 29,700+ verified photovoltaic modules, grid-tie/hybrid inverters, and energy storage batteries. Every parameter is verified against 7 fundamental physical laws from manufacturer datasheets.

CORS: Access-Control-Allow-Origin: *Zero Auth Required (Public v1)Rate Limit: 60 req / min / IPCloudflare Edge Cached (s-maxage=3600)

Quickstart Request

Bash / cURL
Sample API Search Call
curl -s "https://solarqna.com/api/v1/panels/search?q=topcon&limit=2" | jq .

Hardware Search & Catalog

GET/api/v1/panels/search
application/json

Search and filter 21,900+ solar panels by power, efficiency, cell architecture, brand, ALMM, DCR, and keywords.

Query Parameters
ParameterTypeDescription
qstringKeyword query (model, series, technology)
brandstringManufacturer slug (e.g. jinko-solar)
power_classstringBand: under-400w, 400-459w, 460-549w, 550-649w, 650w-plus
efficiency_classstringTier: ultra-24-plus, high-23-24, mid-22-23, standard-under-22
bifacialbooleanFilter bifacial dual-glass modules (true/false)
almmbooleanIndia MNRE ALMM enlisted modules only (true/false)
limitnumberResults per page (1..200, default 50)
offsetnumberPagination offset (default 0)
Sample Call
/api/v1/panels/search
curl -s 'https://solarqna.com/api/v1/panels/search?q=topcon&limit=5'
GET/api/v1/panels/by-slug/:slug
application/json

Retrieve comprehensive STC electrical physics (Voc, Isc, Vmp, Imp, NOCT, temp coefficients), dimensions, and peer-class rankings for a specific solar panel.

Query Parameters
ParameterTypeDescription
slugstringCanonical panel slug (e.g. heliene-108hc-410-m10-sl)
Sample Call
/api/v1/panels/by-slug/:slug
curl -s 'https://solarqna.com/api/v1/panels/by-slug/heliene-108hc-410-m10-sl'
GET/api/v1/inverters/search
application/json

Search 6,380+ solar inverters across string, hybrid, microinverter, and off-grid topologies.

Query Parameters
ParameterTypeDescription
qstringModel or manufacturer query
peer_classstringinverter:micro, inverter:hybrid-1ph, inverter:hybrid-3ph, inverter:string-1ph, inverter:string-3ph
limitnumberPagination limit (1..200)
Sample Call
/api/v1/inverters/search
curl -s 'https://solarqna.com/api/v1/inverters/search?q=hybrid&limit=5'
GET/api/v1/inverters/by-slug/:slug
application/json

Retrieve continuous AC output, MPPT voltage envelopes, CEC/Euro efficiency, and topology standing for any inverter.

Query Parameters
ParameterTypeDescription
slugstringInverter slug (e.g. sungrow-mg5rl)
Sample Call
/api/v1/inverters/by-slug/:slug
curl -s 'https://solarqna.com/api/v1/inverters/by-slug/sungrow-mg5rl'
GET/api/v1/batteries/search
application/json

Search 1,380+ residential and commercial energy storage batteries by usable kWh, continuous kW, and chemistry.

Query Parameters
ParameterTypeDescription
qstringBattery query
peer_classstringbattery:lv:under-6kwh, battery:hv:6-12kwh, battery:hv:12-25kwh, battery:hv:25kwh-plus
limitnumberPagination limit
Sample Call
/api/v1/batteries/search
curl -s 'https://solarqna.com/api/v1/batteries/search?limit=5'
GET/api/v1/batteries/by-slug/:slug
application/json

Retrieve usable storage kWh, peak kW, continuous discharge amps, voltage architecture (LV 48V vs HV 400V), and cycle life.

Query Parameters
ParameterTypeDescription
slugstringBattery slug (e.g. tesla-powerwall-3)
Sample Call
/api/v1/batteries/by-slug/:slug
curl -s 'https://solarqna.com/api/v1/batteries/by-slug/tesla-powerwall-3'

Manufacturers, Macro Stats & Market Offers

GET/api/v1/manufacturers
application/json

Listing of all 659 registered photovoltaic manufacturers with headquarters, founding year, tier rating, website, and compliance tags.

Sample Call
/api/v1/manufacturers
curl -s 'https://solarqna.com/api/v1/manufacturers'
GET/api/v1/stats
application/json

Aggregated real-time catalog statistics, verified SKU counts, technology breakdown, and physics coverage metrics.

Sample Call
/api/v1/stats
curl -s 'https://solarqna.com/api/v1/stats'
GET/api/v1/offers/stats
application/json

Aggregated retailer stock trends and 30-day time-series data across 220 equipment shops in 22 global markets.

Sample Call
/api/v1/offers/stats
curl -s 'https://solarqna.com/api/v1/offers/stats'

Standard JSON Response Envelope

All endpoints return a predictable JSON envelope with status indicators, metadata pagination headers, and structured equipment specifications.

Envelope Schema
{
  "ok": true,
  "meta": {
    "category": "panels",
    "totalCount": 21951,
    "limit": 50,
    "offset": 0,
    "page": 1,
    "totalPages": 440
  },
  "data": [
    {
      "id": "pane-heliene-108hc-410-m10-sl",
      "slug": "heliene-108hc-410-m10-sl",
      "name": "Heliene 108HC-410-M10-SL",
      "brandName": "Heliene",
      "category": "panels",
      "ratedCapacityWp": 410,
      "efficiencyPct": 21.0,
      "powerDensityWpM2": 210.3,
      "peerClass": "panel:400-459W",
      "tempCoeffPmax": -0.34,
      "warrantyYearsProduct": 15,
      "datasheetUrl": "https://assets.solarqna.com/datasheets/panels/heliene/108hc.pdf",
      "ranks": {
        "globalRank": 1240,
        "compositeScore": 76.4
      }
    }
  ]
}