WorldHistory API - Display our content on your website
We have built a simple to use and robust API that can get all the
important data, content, and vital information you need to use on your website
or application. We have information on people, events, places and genealogy. Most
importantly all of this information is geolocated. Terms of use, and the instructions
for using the API are listed below.
In order to use the API you must follow these guidelines
1. You need an API key to use the API. You can register below.
2. If you make links out of the content, these must direct back to our site.
3. Somewhere on the page it must say: "Provided by WorldHistory.com"
4. The text listed in #3 must link to www.worldhistory.com
5. There is a rate limit of 5,000 requests a day. If you hit that limit, you won't be able to use the API for 24 hours. You can license the use of the API, which removes the rate limit.
Our API outputs all of it's data in JSON format. To find out more about JSON visit www.json.org. The API service is a basic REST page that accepts certain GET Requests.
Examples of using the Restful API are all listed below.
For type you have the followng options:
person
event
place
geo (geolocations)
This is the request to access information on people. You can do all sorts of requests to get very specific data on people. You can use these in any combination:
fn=their_first_name
ln=their_last_name
born=appr_year_of_birth
died=appr_year_of_death
adbc=AD_or_BC
fame=one_or_zero (1 for famous)
anc=one_or_zero (1 if they are an ancestor)
tag=a_tag_word
maxrows=number_from_1_to_25
ret=return_style
id=the_persons_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain person. This means the id number must also be sent. You can retrieve:
ops=timeline (their timeline)
ops=lifeevents (life events such as birth, marriage, and death)
ops=people (people who they knew or who are related to them)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the person)
ret=basic (just return basic information)
ret=list (just names)
ret=img (names and images)
ret=text (names and text description)
default is basic
This is the request to access information on events. You can do all sorts of requests to get very specific data on events. You can use these in any combination:
keyword=event_keword
lat=latitude
lng=longitude
range=appr_startyear_to_endyear
adbc=AD_or_BC
tag=a_tag_word
maxrows=number_from_1_to_25
ret=return_style
id=the_event_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain event. This means the id number must also be sent. You can retrieve:
ops=subevents (all of the sub events of one events)
ops=people (people who took place in this event)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the event)
ret=basic (just return basic information)
ret=list (just event name)
ret=img (event names and images)
ret=text (event name and text description)
default is basic
This is the request to access information on places. You can do all sorts of requests to get very specific data on events. You can use these in any combination:
keyword=place_keyword
lat=latitude
lng=longitude
tag=a_tag_word
cat=category_name
maxrows=number_from_1_to_25
ret=return_style
id=the_place_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain place. This means the id number must also be sent. You can retrieve:
ops=nearbyEvents (events that took place near that place)
ops=peopleBorn (people born near that place)
ops=peopleDied (people who died near that place)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the place)
ret=basic (just return basic information)
ret=list (just place names)
ret=img (place names and images)
ret=text (place name and text description)
default is basic
Terms And Conditions
In order to use the API you must follow these guidelines
1. You need an API key to use the API. You can register below.
2. If you make links out of the content, these must direct back to our site.
3. Somewhere on the page it must say: "Provided by WorldHistory.com"
4. The text listed in #3 must link to www.worldhistory.com
5. There is a rate limit of 5,000 requests a day. If you hit that limit, you won't be able to use the API for 24 hours. You can license the use of the API, which removes the rate limit.
Developers
We have built several classes for PHP4 and PHP5 developers to download. These classes help you utilize this API so you can build applications to access historical data. Download our PHP4/PHP5 classes.Directions and Examples
Our API outputs all of it's data in JSON format. To find out more about JSON visit www.json.org. The API service is a basic REST page that accepts certain GET Requests.
Examples of using the Restful API are all listed below.
type=
For type you have the followng options:
person
event
place
geo (geolocations)
type=person
This is the request to access information on people. You can do all sorts of requests to get very specific data on people. You can use these in any combination:
fn=their_first_name
ln=their_last_name
born=appr_year_of_birth
died=appr_year_of_death
adbc=AD_or_BC
fame=one_or_zero (1 for famous)
anc=one_or_zero (1 if they are an ancestor)
tag=a_tag_word
maxrows=number_from_1_to_25
ret=return_style
id=the_persons_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain person. This means the id number must also be sent. You can retrieve:
ops=timeline (their timeline)
ops=lifeevents (life events such as birth, marriage, and death)
ops=people (people who they knew or who are related to them)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the person)
ret=basic (just return basic information)
ret=list (just names)
ret=img (names and images)
ret=text (names and text description)
default is basic
type=event
This is the request to access information on events. You can do all sorts of requests to get very specific data on events. You can use these in any combination:
keyword=event_keword
lat=latitude
lng=longitude
range=appr_startyear_to_endyear
adbc=AD_or_BC
tag=a_tag_word
maxrows=number_from_1_to_25
ret=return_style
id=the_event_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain event. This means the id number must also be sent. You can retrieve:
ops=subevents (all of the sub events of one events)
ops=people (people who took place in this event)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the event)
ret=basic (just return basic information)
ret=list (just event name)
ret=img (event names and images)
ret=text (event name and text description)
default is basic
type=place
This is the request to access information on places. You can do all sorts of requests to get very specific data on events. You can use these in any combination:
keyword=place_keyword
lat=latitude
lng=longitude
tag=a_tag_word
cat=category_name
maxrows=number_from_1_to_25
ret=return_style
id=the_place_id_number
ops=your_options
your_options are a set of keywords used to get information specific to one certain place. This means the id number must also be sent. You can retrieve:
ops=nearbyEvents (events that took place near that place)
ops=peopleBorn (people born near that place)
ops=peopleDied (people who died near that place)
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about the place)
ret=basic (just return basic information)
ret=list (just place names)
ret=img (place names and images)
ret=text (place name and text description)
default is basic
type=geo
This is the request to access basic information based on geolocation. You can different type of data from these geolocations. You can use these in any combination:
lat=latitude
lng=longitude
radius=radius (max is 500)
maxrows=number_from_1_to_25
ret=return_style
return_style is a set of keywords that return just the information you are looking for. Data can be returned with the following:
ret=all (return everything about a geolocation)
ret=peopleBorn (return people born nearby)
ret=peopleDied (return people born nearby)
ret=events (return nearby events)
ret=places (return nearby places)
ret=artifacts (return nearby artifacts)
default is all
Facebook Applications
