500px API Documentation

Getting Started

To use the 500px API, you need to obtain API credentials. Follow these steps:

1. Sign up for a 500px account if you don't already have one
2. Visit the 500px Applications page
3. Click on "Register your application"
4. Fill out the form with your application details
5. Once approved, you'll receive your API key and secret

Authentication

The 500px API uses OAuth 2.0 for authentication. Here's a basic example of how to authenticate:

# Example using Python and requests library
import requests

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
redirect_uri = "YOUR_REDIRECT_URI"

auth_url = f"https://api.500px.com/v1/oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&response_type=code"

# Redirect user to auth_url and get the authorization code
# Then exchange the code for an access token

token_url = "https://api.500px.com/v1/oauth/token"
data = {
    "client_id": client_id,
    "client_secret": client_secret,
    "code": "AUTHORIZATION_CODE",
    "grant_type": "authorization_code",
    "redirect_uri": redirect_uri
}

response = requests.post(token_url, data=data)
access_token = response.json()["access_token"]
    

API Endpoints

Here are some of the main endpoints available in the 500px API:

• GET /v1/photos - Get a list of photos
• GET /v1/photos/{id} - Get a specific photo by ID
• GET /v1/users - Get user information
• POST /v1/photos - Upload a new photo
• PUT /v1/photos/{id} - Update a photo
• DELETE /v1/photos/{id} - Delete a photo