Warning: session_start() [function.session-start]: open(/home/content/61/9499561/tmp/sess_upgpfpuga4r076bnoc2b47omc2, O_RDWR) failed: No such file or directory (2) in /home/content/61/9499561/html/index.php on line 45
API Documentation | Badoostan

Save 50-90% off!

Delivered directly to your inbox.

INWashington DC

Confirm Your City

Enter your email

API Documentation

API Usage

Getting Started

Making a Request

  • All request require your API Key to be passed on the URL as client_id= in the params of the request: GET http://www.badoostan.com/api?client_id=
  • All documented parameters, unless otherwise specified, are required. Optional parameters are marked in the documentations like this: my_optional_parameter (optional)

Getting the Response

  • JSON is the default response format for all requests. XML is available by specifying .xml on the end of the URL path.
  • JSON response without .json on the request URL path GET http://www.badoostan.com/api?client_id= &city=
  • JSON response with .json on the request URL path GET http://www.badoostan.com/api?client_id= &city= &format=json
  • XML response with .xml on the request URL path GET http://www.badoostan.com/api?client_id= &city= &format=xml
  • The Badoostan API also respects the HTTP Accepts header
  • Badoostan responds with a standard error response format and a fixed set of HTTP codes.

Warning: Unknown: open(/home/content/61/9499561/tmp/sess_upgpfpuga4r076bnoc2b47omc2, O_RDWR) failed: No such file or directory (2) in Unknown on line 0

Warning: Unknown: Failed to write session data (files). Please verify that the current setting of session.save_path is correct () in Unknown on line 0