500px API provides programmatic access to 500px functionality and content. Version 1 of the API is limited to the essentials of the website's functionality: viewing feature streams, photo information and comments, as well as user profiles.
The API is REST API and uses OAuth 1.0a for user authentication purposes. Currently, return format for all endpoints is JSON.
You can try our API in console (http://bitly.com/api500px)
See status.500px.com for API status updates, outages, and scheduled maintenance.
upload_key
and replaced with new oneGET
photosGET
photos/searchGET
photos/:idGET
photos/:id/commentsGET
photos/:id/votesPUT
photos/:idPOST
photosPOST
photos/:id/voteDELETE
photos/:id/votePOST
photos/:id/tagsPOST
photos/:id/commentsPOST
photos/:id/reportDELETE
photos/:idDELETE
photos/:id/tagsGET
usersGET
users/showGET
users/:id/friendsGET
users/:id/followersGET
users/searchPOST
users/:id/friendsDELETE
users/:id/friendsGET
users/:user_id/galleriesGET
users/:user_id/galleries/:idGET
users/:user_id/galleries/:id/itemsGET
users/:user_id/galleries/:id/share_urlPUT
users/:user_id/galleries/:idPUT
users/:user_id/galleries/:id/itemsPUT
users/:user_id/galleries/repositionPOST
users/:user_id/galleriesDELETE
users/:user_id/galleries/:idYou can also programmatically access the 500px Directory. The Directory allows you to contact photographers and search for photographers by speciality, availability, service rates, language, camera, and other information. To gain access to the Directory API please contact sales@500px.com.
Got rust on your skills? No worries. Here are the docs you might need to get started:
The API is only available to authenticated clients. Clients should authenticate users using OAuth. Once authenticated, you need to request a resource from one of the endpoints using HTTPS. Generally, reading any data is done through a request with GET method. If you want our server to create, update or delete a given resource, POST or PUT methods are required.
500px API currently returns data in JSON format.
Applications must identify themselves to access any resource. If your application only needs read-only access and does not authenticate the user, consumer_key containing a valid Consumer Key parameter should be specified in the query string. Otherwise, OAuth or upload key authentication takes care of identifying the application as well as the user accessing the API.
There is a rate limit of 1,000,000 API requests per month per account. We will contact you and, if required, disable your application if we find that your application is exceeding this limit or interfering with our system's stability. This revised rate limit came into effect May 1, 2014.