Developer Network NREL NREL Developer Network

Energy Innovations (GET /api/energy-innovations/v1)

This API provides information about energy technologies developed with Department of Energy (DOE) funding and available for licensing. The same information is available at the Energy Innovation Portal website. Included are business-friendly descriptions of the technologies (also referred to as "marketing summaries") and, in many cases, their associated patents.

Documentation

Use of this API requires a special key ("api_key") be included with requests (explanation). You can get such a key here. The examples below use "DEMO_KEY" as the api_key parameter's value. When using the API "for real," you'll use the key issued to you instead. (The value "DEMO_KEY" will only work a limited number of times before being rejected by the service.)

This API only supports HTTP GET requests.

Auto-discovery begins at the root URI: https://developer.nrel.gov/api/energy-innovations/v1?api_key=DEMO_KEY

Request and response examples

This API provides information centric to Patents, Marketing Summaries, Inventors and Assignees.

Patents

(patents for energy related technologies)
To retrieve all:
https://developer.nrel.gov/api/energy-innovations/v1/patents?api_key=DEMO_KEY
Find by patent number:
https://developer.nrel.gov/api/energy-innovations/v1/patents/search/patentNumber?patentNumber=8,330,319&api_key=DEMO_KEY
Find by a date range:
https://developer.nrel.gov/api/energy-innovations/v1/patents/search/issueDate?after=2013-01-01&before=2013-01-05&api_key=DEMO_KEY
Find by a technolgy category:
https://developer.nrel.gov/api/energy-innovations/v1/patents/search/technologyCategory?categoryName=Geothermal&api_key=DEMO_KEY
Find by a laboratory:
https://developer.nrel.gov/api/energy-innovations/v1/patents/search/lab?labName=Los%20Alamos%20National%20Laboratory&api_key=DEMO_KEY

Marketing Summaries

(business-friendly descriptions of energy related technologies)
To retrieve all:
https://developer.nrel.gov/api/energy-innovations/v1/marketingSummaries?api_key=DEMO_KEY
Find by a date range:
https://developer.nrel.gov/api/energy-innovations/v1/marketingSummaries/search/issueDate?after=2011-02-01&before=2015-02-15&api_key=DEMO_KEY
Find by a technolgy category:
https://developer.nrel.gov/api/energy-innovations/v1/marketingSummaries/search/technologyCategory?categoryName=Wind%20Energy&api_key=DEMO_KEY
Find by a laboratory:
https://developer.nrel.gov/api/energy-innovations/v1/marketingSummaries/search/lab?labName=Oak%20Ridge%20National%20Laboratory&api_key=DEMO_KEY

Inventors

(those that conceived the inventions)
To retrieve all:
https://developer.nrel.gov/api/energy-innovations/v1/inventors?api_key=DEMO_KEY
Find by name:
https://developer.nrel.gov/api/energy-innovations/v1/inventors/search/name?name=Bliss,%20Mary&api_key=DEMO_KEY
Find by patent number:
https://developer.nrel.gov/api/energy-innovations/v1/inventors/search/patentNumber?patentNumber=8,330,319&api_key=DEMO_KEY

Assignees

(those that have property rights to the patents)
To retrieve all:
https://developer.nrel.gov/api/energy-innovations/v1/assignees?api_key=DEMO_KEY
Find by name:
https://developer.nrel.gov/api/energy-innovations/v1/assignees/search/name?name=General%20Electric%20Company&api_key=DEMO_KEY
Find by patent number:
https://developer.nrel.gov/api/energy-innovations/v1/assignees/search/patentNumber?patentNumber=8,330,319&api_key=DEMO_KEY

Sample error responses

400 (Bad Request) example: https://developer.nrel.gov/api/energy-innovations/v1/marketingSummaries/search/issueDate?after=badValue&api_key=DEMO_KEY
404 (Not Found) example: https://developer.nrel.gov/api/energy-innovations/v1/doesNotExist?api_key=DEMO_KEY
500 (Internal Server Error) example: https://developer.nrel.gov/api/api/energy-innovations/v1/sample500Error?api_key=DEMO_KEY
Additionally, standard errors may be returned.

Rate limits

Standard rate limits apply. No more than 1,000 requests may be made in any hour.

Need additional help?

Email us: techportal@nrel.gov

Help Improve this Content