Get your API Key for free!
Build amazing apps!
AstroBin implements a basic set of RESTful APIs. Currently the APIs are read-only, and they allow you to get data about images, and perform some basic searches.
Using AstroBin's APIs you will be able to create your own website, desktop application of mobile app that can use some content from AstroBin.
AstroBin's API currently are limited to retrieving basic information and perform simple search on images.
The supported response types are XML and JSON.
The first thing you will need is an API Key. Please use the API Key request form to get one.
If you get an Image object using the APIs, it will have a filename and original_ext field. To display the image, you must append them to http://cdn.astrobin.com/images/.
This will give you the full size image. If you want a smaller version, you can append _resized to the filename.
For a thumbnail, append _thumb and use the .png extension.
Using the APIs to mercilessly scrape all the available content is not allowed. Failure to respect this requirement will result in the permanent revocation of one's API Key.
Please read the API section in the Terms of Service.
Remember that you can combine most of these queries, so feel free to experiment!
|Get the 5 top-rated images:||
|Get a single image by ID:||
|Search by subject:||
|Search by user:||
|Search by case-insensitive, partial title:||
|Search by case-insensitive, partial description:||
|Other useful partial tricks:||
|Search by upload date range:||
|Search only plate-solved images||
|Search by field size:|
|Get today's Image Of The Day:||
|Get yesterdays's Image Of The Day:||