/CelebInfo-API

Unofficial API of famousbirthdays.com

Primary LanguagePython

<img src="http://i1.wp.com/blog.mashape.com/wp-content/uploads/2013/02/Screen_Shot_2013-02-12_at_6.53.42_PM.png"

CelebInfo-API

Unofficial API of famousbirthdays.com

About

CelebInfo is a simple API which will give you access to the information like birthdays etc. With this API you will get these data of celebrities.

  • Name
  • Age
  • Birthday
  • Birth Year
  • Birth Place
  • Birth Sign
  • Occupation
  • Photo

Documentation

API documentation here is for python language. To use this in python you need to install unirest module.

sudo pip install unirest

###Search By Birthday API Request syntax :

response = unirest.get("https://daxeel-celebinfo-v1.p.mashape.com/date/{DATE}/{MONTH_IN_WORDS}",
  headers={
    "X-Mashape-Key": "V96M0xptxxxxxx",
    "Accept": "text/plain"
  }
)

where,
DATE and MONTH_IN_WORDS is a day and API will give you the data of all celebrities having birthday on this specified date and month.
For example,

response = unirest.get("https://daxeel-celebinfo-v1.p.mashape.com/date/28/september",
  headers={
    "X-Mashape-Key": "V96M0xptxxxxxx",
    "Accept": "text/plain"
  }
)

Response will be like this,

{
	"data": [{
		"age": "18",
		"birth_place": "Harij, Gujarat, India",
		"birth_sign": "Pisces",
		"birth_year": "1996",
		"birthday": "September 28",
		"name": "Daxeel Soni",
		"occupation": "Developer of this API. More: www.daxeelsoni.in",
		"photo_url": "http://daxeelsoni.in/images/me.jpg"
	}, {
		"age": 28,
		"birth_place": "Houston",
		"birth_sign": "Libra",
		"birth_year": "1987",
		"birthday": "September 28",
		"name": "Hilary Duff",
		"occupation": "TV Actress",
		"photo_url": "http://www.famousbirthdays.com/thumbnails/duff-hilary-medium.jpg"
	}, {
		"age": 38,
		"birth_place": "Columbia",
		"birth_sign": "Libra",
		"birth_year": "1977",
		"birthday": "September 28",
		"name": "Young Jeezy",
		"occupation": "Rapper",
		"photo_url": "http://www.famousbirthdays.com/thumbnails/jeezy-young-medium.jpg"
	}, {
		"age": 48,
		"birth_place": "Roanoke",
		"birth_sign": "Libra",
		"birth_year": "1967",
		"birthday": "September 28",
		"name": "Challen Cates",
		"occupation": "TV Actress",
		"photo_url": "http://www.famousbirthdays.com/thumbnails/cates-challen-medium.jpg"
	}]
}



Custom Search

API Request syntax :
```py response = unirest.get("https://daxeel-celebinfo-v1.p.mashape.com/custom/{SEARCH_TYPE}", headers={ "X-Mashape-Key": "V96M0xptxxxxxx" } ) ```
where,
SEARCH_TYPE can be

yesterday Returns info of celebrities having birthdays yesterday
today Returns info of celebrities having birthdays today
tomorrow Returns info of celebrities having birthdays to tomorrow
tdat Returns info of celebrities having birthdays the after tomorrow

For example, ```py response = unirest.get("https://daxeel-celebinfo-v1.p.mashape.com/custom/today", headers={ "X-Mashape-Key": "V96M0xptxxxxxx" } ) ``` Response will be like this, ```json { "data": [{ "age": 20, "birth_place": "Houston", "birth_sign": "Aquarius", "birth_year": "1996", "birthday": "January 23", "name": "Chachi Gonzales", "occupation": "Dancer", "photo_url": "http://www.famousbirthdays.com/thumbnails/gonzales-chachi-medium.jpg" }, { "age": 32, "birth_place": "Netherlands", "birth_sign": "Aquarius", "birth_year": "1984", "birthday": "January 23", "name": "Arjen Robben", "occupation": "Soccer Player", "photo_url": "http://www.famousbirthdays.com/thumbnails/robben-arjen-medium.jpg" }, { "age": 31, "birth_place": "Pennsylvania", "birth_sign": "Aquarius", "birth_year": "1985", "birthday": "January 23", "name": "Draya Michele", "occupation": "Reality Star", "photo_url": "http://www.famousbirthdays.com/thumbnails/michele-draya-medium.jpg" }, { "age": 24, "birth_place": "New Jersey", "birth_sign": "Aquarius", "birth_year": "1992", "birthday": "January 23", "name": "Louis Giordano", "occupation": "Vine Star", "photo_url": "http://www.famousbirthdays.com/thumbnails/giordano-louis-medium.jpg" }] } ```