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