This API was made to read the-numbers.com to get the production budget and gross revenue. Depending on the profit it tells you to either buy the movie, or don't buy it (i.e. download it).
Basically lets you know if you should feel guilty for downloading a movie.
Here are the arguments:
| Argument | Required | Description |
| t | yes | This is the title of the film, of course, you need this. |
| y | no | This is the year the film was released. Its inclusion ensures more accurate results |
| f | no | Format to return the data in.
Not specifying returns a nicely formatted info box. json and xml are available php returns a serialized array |
| c | no | Not specified means load data from cache.
Setting this to 1 means skip the cache and load fresh data. If you are getting funny results try this. |
Some movies don't have all the budget details so the profit cannot be calculated. This is also in beta so don't expect it to work all the time. There is no search results interface but I may create one in the future.
Protip: Enter the exact movie name for a more accurate result e.g. X-Men Origins: Wolverine
Example: http://hamstar.co.nz/api/api_thenumbers.php?t=X-Men Origins: Wolverine&y=2009
These are the statistics for the movies collected so far.
Feel free to download these movies, the invested parties are doing just fine.
| Name | Year | Profit |
| Titanic | 1997 | $1,648,813,795 |
| Avatar | 2009 | $1,602,741,499 |
| The Lord of the Rings: The Return of the King | 2003 | $1,039,027,325 |
| Pirates of the Caribbean: Dead Man's Chest | 2006 | $915,659,812 |
| Harry Potter and the Deathly Hallows: Part II | 2011 | $901,948,085 |
| Toy Story 3 | 2010 | $860,726,000 |
| Jurassic Park | 1993 | $860,067,947 |
| Harry Potter and the Sorcerer's Stone | 2001 | $851,457,891 |
| Shrek 2 | 2004 | $849,838,758 |
| The Lion King | 1994 | $848,882,974 |