Nobel Prizes
Nobel Prizes is a simple tool for getting information on Nobel Prizes. It returns information on various Nobel Prizes.
This API provides reliable and fast access to nobel prizes data through a simple REST interface. Built for developers who need consistent, high-quality results with minimal setup time.
To use this API, you need an API key. You can get one by creating a free account and visiting your dashboard.
View API in DirectoryEndpoint
GET https://api.apiverve.com/v1/nobelprizes
Code Examples
Here are examples of how to call this API in different programming languages:
curl -X GET \
"https://api.apiverve.com/v1/nobelprizes?firstname=Albert&lastname=Einstein&category=Physics&year=1921" \
-H "X-API-Key: your_api_key_here"
const response = await fetch('https://api.apiverve.com/v1/nobelprizes', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);
import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/nobelprizes', headers=headers)
data = response.json()
print(data)
const https = require('https');
const url = require('url');
const options = {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
};
const req = https.request('https://api.apiverve.com/v1/nobelprizes', options, (res) => {
let data = '';
res.on('data', (chunk) => data += chunk);
res.on('end', () => console.log(JSON.parse(data)));
});
req.end();
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.apiverve.com/v1/nobelprizes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: your_api_key_here',
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/nobelprizes", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
require 'net/http'
require 'json'
uri = URI('https://api.apiverve.com/v1/nobelprizes')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'your_api_key_here'
request['Content-Type'] = 'application/json'
response = http.request(request)
puts JSON.pretty_generate(JSON.parse(response.body))
Authentication
This API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_here
Parameters
The following parameters are available for this API endpoint:
Parameter | Type | Required | Location | Description | Example |
---|---|---|---|---|---|
firstname | string | No | query | The first name of the Nobel Prize winner to get information about | Albert |
lastname | string | No | query | The last name of the Nobel Prize winner to get information about | Einstein |
category | string | No | query | The category of the Nobel Prize to get information about (e.g., Physics, Chemistry, Medicine, Peace, etc) | Physics |
year | string | No | query | The year of the Nobel Prize to get information about (e.g., 1921) | 1921 |
Response
The API returns responses in JSON, XML, and YAML formats:
Example Responses
{
"status": "ok",
"error": null,
"data": {
"count": 1,
"filteredOn": [
"firstName",
"lastName",
"category",
"year"
],
"nobelPrizes": [
{
"firstName": "Albert",
"lastName": "Einstein",
"born": "1879-03-14",
"died": "1955-04-18",
"countryborn": "Germany",
"countrybornCode": "DE",
"born city": "Ulm",
"diedCountry": "USA",
"diedCountryCode": "US",
"diedCity": "Princeton NJ",
"gender": "male",
"year": "1921",
"category": "Physics",
"motivation": "for his services to Theoretical Physics and especially for his discovery of the law of the photoelectric effect",
"organization": "Kaiser-Wilhelm-Institut (now Max-Planck-Institut) für Physik",
"organizationCity": "Berlin",
"organizationCountry": "Germany"
}
]
}
}
<Root>
<status>ok</status>
<error />
<data>
<count>1</count>
<filteredOn>firstName</filteredOn>
<filteredOn>lastName</filteredOn>
<filteredOn>category</filteredOn>
<filteredOn>year</filteredOn>
<nobelPrizes>
<firstName>Albert</firstName>
<lastName>Einstein</lastName>
<born>1879-03-14</born>
<died>1955-04-18</died>
<countryborn>Germany</countryborn>
<countrybornCode>DE</countrybornCode>
<born_x0020_city>Ulm</born_x0020_city>
<diedCountry>USA</diedCountry>
<diedCountryCode>US</diedCountryCode>
<diedCity>Princeton NJ</diedCity>
<gender>male</gender>
<year>1921</year>
<category>Physics</category>
<motivation>for his services to Theoretical Physics and especially for his discovery of the law of the photoelectric effect</motivation>
<organization>Kaiser-Wilhelm-Institut (now Max-Planck-Institut) für Physik</organization>
<organizationCity>Berlin</organizationCity>
<organizationCountry>Germany</organizationCountry>
</nobelPrizes>
</data>
</Root>
status: ok
error:
data:
count: 1
filteredOn:
- firstName
- lastName
- category
- year
nobelPrizes:
- firstName: Albert
lastName: Einstein
born: 1879-03-14
died: 1955-04-18
countryborn: Germany
countrybornCode: DE
born city: Ulm
diedCountry: USA
diedCountryCode: US
diedCity: Princeton NJ
gender: male
year: 1921
category: Physics
motivation: for his services to Theoretical Physics and especially for his discovery of the law of the photoelectric effect
organization: Kaiser-Wilhelm-Institut (now Max-Planck-Institut) für Physik
organizationCity: Berlin
organizationCountry: Germany
Response Structure
All API responses follow a consistent structure with the following fields:
Field | Type | Description | Example |
---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Response Data Fields
When the request is successful, the data
object contains the following fields:
Field | Type | Sample Value |
---|---|---|
count | number | 1 |
filteredOn | array | ["firstName", ...] |
nobelPrizes | array | [{"firstName":"Albert","lastName":"Einstein","born":"1879-03-14","died":"1955-04-18","countryborn":"Germany","countrybornCode":"DE","born city":"Ulm","diedCountry":"USA","diedCountryCode":"US","diedCity":"Princeton NJ","gender":"male","year":"1921","category":"Physics","motivation":"for his services to Theoretical Physics and especially for his discovery of the law of the photoelectric effect","organization":"Kaiser-Wilhelm-Institut (now Max-Planck-Institut) für Physik","organizationCity":"Berlin","organizationCountry":"Germany"}] |
Headers
Required and optional headers for API requests:
Header Name | Required | Example Value | Description |
---|---|---|---|
X-API-Key | Yes | your_api_key_here | Your APIVerve API key. Found in your dashboard under API Keys. |
Accept | No | application/json | Specify response format: application/json (default), application/xml, or application/yaml |
User-Agent | No | MyApp/1.0 | Identifies your application for analytics and debugging purposes |
X-Request-ID | No | req_123456789 | Custom request identifier for tracking and debugging requests |
Cache-Control | No | no-cache | Control caching behavior for the request and response |
Client Libraries
To get started with minimal code, most of our APIs are available through client libraries and clients:
Error Codes
The API uses standard HTTP status codes to indicate success or failure:
Status Code | Message | Description |
---|---|---|
200 | OK | Request successful, data returned |
400 | Bad Request | Invalid request parameters or malformed request |
401 | Unauthorized | Missing or invalid API key |
403 | Forbidden | API key does not have permission for this endpoint |
429 | Too Many Requests | Rate limit exceeded, please slow down requests |
500 | Internal Server Error | Server error, please try again later |
Was this page helpful?
Help us improve our documentation